@tauri-apps/api/app

Functions

defaultWindowIcon()

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

Defined in: packages/api/src/app.ts:197

Gets the default window icon.

Example

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

Returns

Promise<Image | null>

Since

2.0.0

---

fetchDataStoreIdentifiers()

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

Defined in: packages/api/src/app.ts:160

Fetches the data store identifiers on macOS and iOS.

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

Example

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

Returns

Promise<DataStoreIdentifier[]>

Since

2.4.0

---

getBundleType()

function getBundleType(): Promise<BundleType>;

Defined in: packages/api/src/app.ts:251

Gets the application bundle type.

Example

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

Returns

Promise<BundleType>

Since

2.5.0

---

getIdentifier()

function getIdentifier(): Promise<string>;

Defined in: packages/api/src/app.ts:112

Gets the application identifier.

Example

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

Returns

Promise<string>

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

Since

2.4.0

---

getName()

function getName(): Promise<string>;

Defined in: packages/api/src/app.ts:81

Gets the application name.

Example

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

Returns

Promise<string>

Since

1.0.0

---

getTauriVersion()

function getTauriVersion(): Promise<string>;

Defined in: packages/api/src/app.ts:96

Gets the Tauri framework version used by this application.

Example

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

Returns

Promise<string>

Since

1.0.0

---

getVersion()

function getVersion(): Promise<string>;

Defined in: packages/api/src/app.ts:67

Gets the application version.

Example

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

Returns

Promise<string>

Since

1.0.0

---

hide()

function hide(): Promise<void>;

Defined in: packages/api/src/app.ts:143

Hides the application on macOS.

Example

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

Returns

Promise<void>

Since

1.2.0

---

onBackButtonPress()

function onBackButtonPress(handler: (payload: OnBackButtonPressPayload) => void): Promise<PluginListener>;

Defined in: packages/api/src/app.ts:267

Listens to the backButton event on Android.

Parameters

Parameter	Type	Description
handler	(payload: OnBackButtonPressPayload) => void	-

Returns

Promise<PluginListener>

---

removeDataStore()

function removeDataStore(uuid: DataStoreIdentifier): Promise<void>;

Defined in: packages/api/src/app.ts:181

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.

Example

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

Parameters

Parameter	Type
uuid	DataStoreIdentifier

Returns

Promise<void>

Since

2.4.0

---

setDockVisibility()

function setDockVisibility(visible: boolean): Promise<void>;

Defined in: packages/api/src/app.ts:236

Sets the dock visibility for the application on macOS.

Example

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

Parameters

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

Returns

Promise<void>

Since

2.5.0

---

setTheme()

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

Defined in: packages/api/src/app.ts:219

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

Example

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

Platform-specific

• iOS / Android: Unsupported.

Parameters

Parameter	Type
theme?	Theme | null

Returns

Promise<void>

Since

2.0.0

---

show()

function show(): Promise<void>;

Defined in: packages/api/src/app.ts:128

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

Example

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

Returns

Promise<void>

Since

1.2.0

---

supportsMultipleWindows()

function supportsMultipleWindows(): Promise<boolean>;

Defined in: packages/api/src/app.ts:277

Returns

Promise<boolean>

Enumerations

BundleType

Defined in: packages/api/src/app.ts:36

Bundle type of the current application.

Enumeration Members

Enumeration Member	Value	Description	Defined in
App	"app"	macOS app bundle	packages/api/src/app.ts:48
AppImage	"appimage"	Linux AppImage	packages/api/src/app.ts:46
Deb	"deb"	Linux Debian package	packages/api/src/app.ts:42
Msi	"msi"	Windows MSI	packages/api/src/app.ts:40
Nsis	"nsis"	Windows NSIS	packages/api/src/app.ts:38
Rpm	"rpm"	Linux RPM	packages/api/src/app.ts:44

Type Aliases

DataStoreIdentifier

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

Defined in: packages/api/src/app.ts:14

Identifier type used for data stores on macOS and iOS.

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

---

OnBackButtonPressPayload

type OnBackButtonPressPayload = {
  canGoBack: boolean;
};

Defined in: packages/api/src/app.ts:258

Payload for the onBackButtonPress event.

Properties

Property	Type	Description	Defined in
canGoBack	boolean	Whether the webview canGoBack property is true.	packages/api/src/app.ts:260