app

Application metadata and lifecycle APIs: version and identifier, theme and dock visibility, data stores and exiting the app.

This package is also accessible with window.__TAURI__.app when app.withGlobalTauri in tauri.conf.json is set to true.

Remarks

Only the read-only commands are enabled by core:app:default (allow-version, allow-name, allow-tauri-version, allow-identifier, allow-bundle-type, allow-supports-multiple-windows, allow-register-listener and allow-remove-listener). Every other function in this module documents the permission it needs, which you must add to a capability yourself.

Enumerations

BundleType

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L57

Bundle type of the current application.

See

getBundleType

Since

2.7.0

Enumeration Members

App

App: "app";

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L69

macOS app bundle

AppImage

AppImage: "appimage";

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L67

Linux AppImage

Deb

Deb: "deb";

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L63

Linux Debian package

Msi

Msi: "msi";

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L61

Windows MSI

Nsis

Nsis: "nsis";

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L59

Windows NSIS

Rpm

Rpm: "rpm";

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L65

Linux RPM

Type Aliases

DataStoreIdentifier

type DataStoreIdentifier = [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L31

Identifier type used for data stores on macOS and iOS.

Represents a 128-bit identifier, commonly expressed as a 16-byte UUID.

Since

2.4.0

---

OnBackButtonPressPayload

type OnBackButtonPressPayload = object;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L294

Payload for the onBackButtonPress event.

Since

2.9.0

Properties

Property	Type	Description	Defined in
canGoBack	boolean	Whether the webview canGoBack property is true.	Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L296

Functions

defaultWindowIcon()

function defaultWindowIcon(): Promise<Image | null>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L225

Gets the default window icon.

Returns

Promise<Image | null>

Example

import { defaultWindowIcon } from '@tauri-apps/api/app';
const icon = await defaultWindowIcon();

Remarks

Requires the core:app:allow-default-window-icon permission (not included in core:app:default).

Since

2.0.0

---

exit()

function exit(code?): Promise<void>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L400

Exits the app with the given exit code.

This is the same as the exit function of the @tauri-apps/plugin-process plugin, but does not require a plugin to be installed.

Platform-specific

• Android: The activity is finished instead of the process being killed, so the app closes with the system transition; code is ignored.

Parameters

Parameter	Type	Default value	Description
code	number	0	The exit code to use. Defaults to 0.

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { exit } from '@tauri-apps/api/app';
await exit(1);

Remarks

Requires the core:app:allow-exit permission (not included in core:app:default).

Since

2.12.0

---

fetchDataStoreIdentifiers()

function fetchDataStoreIdentifiers(): Promise<DataStoreIdentifier[]>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L182

Fetches the data store identifiers on macOS and iOS.

See https://developer.apple.com/documentation/webkit/wkwebsitedatastore for more information.

Returns

Promise<DataStoreIdentifier[]>

Example

import { fetchDataStoreIdentifiers } from '@tauri-apps/api/app';
const ids = await fetchDataStoreIdentifiers();

Remarks

Requires the core:app:allow-fetch-data-store-identifiers permission (not included in core:app:default).

Since

2.4.0

---

getBundleType()

function getBundleType(): Promise<BundleType>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L285

Gets the application bundle type.

Returns

Promise<BundleType>

Example

import { getBundleType } from '@tauri-apps/api/app';
const type = await getBundleType();

Since

2.5.0

---

getIdentifier()

function getIdentifier(): Promise<string>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L127

Gets the application identifier.

Returns

Promise<string>

The application identifier as configured in tauri.conf.json.

Example

import { getIdentifier } from '@tauri-apps/api/app';
const identifier = await getIdentifier();

Since

2.4.0

---

getName()

function getName(): Promise<string>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L96

Gets the application name.

Returns

Promise<string>

Example

import { getName } from '@tauri-apps/api/app';
const appName = await getName();

Since

1.0.0

---

getTauriVersion()

function getTauriVersion(): Promise<string>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L111

Gets the Tauri framework version used by this application.

Returns

Promise<string>

Example

import { getTauriVersion } from '@tauri-apps/api/app';
const tauriVersion = await getTauriVersion();

Since

1.0.0

---

getVersion()

function getVersion(): Promise<string>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L82

Gets the application version.

Returns

Promise<string>

Example

import { getVersion } from '@tauri-apps/api/app';
const appVersion = await getVersion();

Since

1.0.0

---

hide()

function hide(): Promise<void>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L162

Hides the application on macOS.

Returns

Promise<void>

Example

import { hide } from '@tauri-apps/api/app';
await hide();

Remarks

Requires the core:app:allow-app-hide permission (not included in core:app:default).

Since

1.2.0

---

onBackButtonPress()

function onBackButtonPress(handler): Promise<PluginListener>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L333

Listens to the Android hardware/gesture back button.

Registering a handler takes over the default behavior, so the app no longer navigates back or closes on its own: decide what to do inside the handler, using payload.canGoBack to know whether the webview has history to go back to.

Platform-specific

• Android: Supported.
• Windows / Linux / macOS / iOS: Unsupported, the handler is never called.

Parameters

Parameter	Type	Description
handler	(payload) => void	Called on every back button press.

Returns

Promise<PluginListener>

A listener handle, call unregister() on it to restore the default behavior.

Example

import { onBackButtonPress } from '@tauri-apps/api/app';
import { exit } from '@tauri-apps/api/app';

const listener = await onBackButtonPress(({ canGoBack }) => {
  if (canGoBack) {
    window.history.back();
  } else {
    void exit(0);
  }
});

// stop handling the back button
await listener.unregister();

Since

2.9.0

---

removeDataStore()

function removeDataStore(uuid): Promise<void>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L206

Removes the data store with the given identifier.

Note that any webview using this data store should be closed before running this API.

See https://developer.apple.com/documentation/webkit/wkwebsitedatastore for more information.

Parameters

Parameter	Type
uuid	DataStoreIdentifier

Returns

Promise<void>

Example

import { fetchDataStoreIdentifiers, removeDataStore } from '@tauri-apps/api/app';
for (const id of (await fetchDataStoreIdentifiers())) {
  await removeDataStore(id);
}

Remarks

Requires the core:app:allow-remove-data-store permission (not included in core:app:default).

Since

2.4.0

---

setDockVisibility()

function setDockVisibility(visible): Promise<void>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L270

Sets the dock visibility for the application on macOS.

Parameters

Parameter	Type	Description
visible	boolean	Whether the dock should be visible or not.

Returns

Promise<void>

Example

import { setDockVisibility } from '@tauri-apps/api/app';
await setDockVisibility(false);

Remarks

Requires the core:app:allow-set-dock-visibility permission (not included in core:app:default).

Since

2.5.0

---

setTheme()

function setTheme(theme?): Promise<void>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L250

Sets the application’s theme. Pass in null or undefined to follow the system theme.

Parameters

Parameter	Type
theme?	Theme | null

Returns

Promise<void>

Example

import { setTheme } from '@tauri-apps/api/app';
await setTheme('dark');

Platform-specific

• iOS / Android: Unsupported.

Remarks

Requires the core:app:allow-set-app-theme permission (not included in core:app:default).

Since

2.0.0

---

show()

function show(): Promise<void>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L145

Shows the application on macOS. This function does not automatically focus any specific app window.

Returns

Promise<void>

Example

import { show } from '@tauri-apps/api/app';
await show();

Remarks

Requires the core:app:allow-app-show permission (not included in core:app:default).

Since

1.2.0

---

supportsMultipleWindows()

function supportsMultipleWindows(): Promise<boolean>;

Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/app.ts#L371

Whether the current platform can show more than one window at a time.

Use it to hide or disable multi-window features on platforms where creating a second window is not possible.

Platform-specific

• Windows / Linux / macOS: Always true.
• Android: true on API level 32 (Android 12L) and above.
• iOS: Reflects UIApplication.supportsMultipleScenes, so it is true on iPadOS and false on iPhone.

See the mobile multiwindow guide for how windows behave on mobile.

Returns

Promise<boolean>

Example

import { supportsMultipleWindows } from '@tauri-apps/api/app';
import { WebviewWindow } from '@tauri-apps/api/webviewWindow';

if (await supportsMultipleWindows()) {
  new WebviewWindow('settings', { url: '/settings' });
}

Since

2.11.0