<doc>
	<legacy_id>3388</legacy_id>
	<name>launch url</name>
	<type>command</type>

	<syntax>
		<example>launch url <i>urlToLaunch</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Launches a url in the appropriate manner for the current system.</summary>

	<examples>
<example>launch url &quot;http://www.runrev.com&quot;</example>
<example>launch url &quot;file:/Users/ben/Desktop/test.pdf&quot;</example>
<example><p>launch url &quot;tel:44 7818 8822&quot;</p></example>
	</examples>

	<history>
		<introduced version="2.9">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="4.5.2">iOS support added</changed>
<changed version="4.6.1">Android support added</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<mobile/>
	</classes>

	<security>
		<process/>
	</security>


	<classification>
	</classification>

	<references>
		<command tag="launch document">launch document Command</command>
		<command tag="revGoURL">revGoURL Command</command>
		<command tag="launch">launch Command</command>
		<keyword tag="URL">URL Keyword</keyword>
	</references>

	<description>
	<overview>Use the <b>launch url</b> 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. </overview>

		<parameters>
  <parameter>
    <name>urlToOpen</name>
	<description>The url to launch. Can be in the following forms:</description>
	<options title="">
		<option>
			<item>http: url</item>
			<description>will launch in the default browser application if available.</description>
		</option>
                <option>
			<item>file: path</item>
			<description>open the file in the associated application</description>
		</option>
                <option>
			<item>tel: url</item>
			<description>open the dialer with a given phone number</description>
		</option>
	</options>
  </parameter>		</parameters>

	<value>When <b>launch url</b> is called, LiveCode checks to see if an application is available to handle the URL. If no such application exists, the command returns &quot;no association&quot; in the result.</value>
	<comments><note>The urlToLaunch must be a standards-compliant URL, in particular file urls must be of the form file://&lt;absolute path&gt;.<p></note><p></p><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.</important></comments>
	</description>
</doc>