launch url

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
launch url <urlToLaunch>
Summary

Launches a url in the appropriate manner for the current system.

Introduced2.9
OSmac, windows, linux, ios, android
Platformsdesktop, mobile
Parameters
NameTypeDescription
urlToLaunch

The URL to launch.

Example
launch url "http://www.livecode.com"
launch url "file:/Users/ben/Desktop/test.pdf"
launch url "tel:44 7818 8822"
Values
NameTypeDescription
The result

When launch url is called, LiveCode checks to see if an application is available to handle the URL. If no such application exists, the command returns "no association" in the result.

RelatedKeyword: URL
Command: revGoURL, launch, launch document
Function: URLEncode
Glossary: URL, URL scheme
Securityprocess
Description

Use the launch url command to open a url using the default action for the current system. The command performs an action appropriate to the protocol and address provided in the given URL.

The following URL schemes are supported:

  • http: and https: URLs, which launch in the default browser application if available
  • file: URLs, which open the file in the associated application
  • tel: URLs, which open the dialer with a given phone number

Note: The urlToLaunch must be a standards-compliant URL. In particular, file: URLs must be of the form file://<b>absolute path</b>, and the path should be URL-encoded.

Important: Mobile: Successfully launching a url will cause another application to open and the requesting application to be quit. The application will receive a shutdown message before this happens.

*Android:* files in specialFolderPath("engine") and specialFolderPath("resources") cannot be accessed via launch url.