(open-url: String) → Command

When this macro is evaluated, the player's browser attempts to open a new tab with the given URL. This will usually require confirmation from the player, as most browsers block Javascript programs such as Harlowe from opening tabs by default.

Example usage:

(open-url: "http://www.example.org/")


If the given URL is invalid, no error will be reported - the browser will simply attempt to open it anyway.

Much like the <a> HTML element, the URL is treated as a relative URL if it doesn't start with “http:”, “https:”, or another such protocol. This means that if your story file is hosted at “http://www.example.org/story.html”, then (open-url: "page2.html") will actually open the URLhttp://www.example.org/page2.html”.

See also: