@tauri-apps/plugin-deep-link

Functions

getCurrent()

function getCurrent(): Promise<string[] | null>

Get the current URLs that triggered the deep link. Use this on app load to check whether your app was started via a deep link.

Returns

Promise<string[] | null>

Example

import { getCurrent } from '@tauri-apps/plugin-deep-link';
const urls = await getCurrent();

- Windows / Linux: Unsupported.

Since

2.0.0

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/deep-link/guest-js/index.ts#L21

---

isRegistered()

function isRegistered(protocol): Promise<boolean>

Check whether the app is the default handler for the specified protocol.

Parameters

Parameter	Type	Description
protocol	string	The name of the protocol without ://.

Returns

Promise<boolean>

Example

import { isRegistered } from '@tauri-apps/plugin-deep-link';
await isRegistered("my-scheme");

- macOS / Android / iOS: Unsupported, always returns true.

Since

2.0.0

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/deep-link/guest-js/index.ts#L78

---

onOpenUrl()

function onOpenUrl(handler): Promise<UnlistenFn>

Helper function for the deep-link://new-url event to run a function each time the protocol is triggered while the app is running. Use getCurrent on app load to check whether your app was started via a deep link.

Parameters

Parameter	Type
handler	(urls) => void

Returns

Promise<UnlistenFn>

Example

import { onOpenUrl } from '@tauri-apps/plugin-deep-link';
await onOpenUrl((urls) => { console.log(urls) });

- Windows / Linux: Unsupported, the OS will spawn a new app instance passing the URL as a CLI argument.

Since

2.0.0

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/deep-link/guest-js/index.ts#L97

---

register()

function register(protocol): Promise<null>

Register the app as the default handler for the specified protocol.

Parameters

Parameter	Type	Description
protocol	string	The name of the protocol without ://. For example, if you want your app to handle tauri:// links, call this method with tauri as the protocol.

Returns

Promise<null>

Example

import { register } from '@tauri-apps/plugin-deep-link';
await register("my-scheme");

- macOS / Android / iOS: Unsupported.

Since

2.0.0

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/deep-link/guest-js/index.ts#L40

---

unregister()

function unregister(protocol): Promise<null>

Unregister the app as the default handler for the specified protocol.

Parameters

Parameter	Type	Description
protocol	string	The name of the protocol without ://.

Returns

Promise<null>

Example

import { unregister } from '@tauri-apps/plugin-deep-link';
await unregister("my-scheme");

- macOS / Linux / Android / iOS: Unsupported.

Since

2.0.0

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/deep-link/guest-js/index.ts#L59