@tauri-apps/plugin-notification

Send toast notifications (brief auto-expiring OS window element) to your user. Can also be used with the Notification Web API.

Enumerations

Importance

Source: undefined

Enumeration Members

Default

Default: 3;

Source: undefined

High

High: 4;

Source: undefined

Low

Low: 2;

Source: undefined

Min

Min: 1;

Source: undefined

None

None: 0;

Source: undefined

---

ScheduleEvery

Source: undefined

Enumeration Members

Day

Day: "day";

Source: undefined

Hour

Hour: "hour";

Source: undefined

Minute

Minute: "minute";

Source: undefined

Month

Month: "month";

Source: undefined

Second

Second: "second";

Source: undefined

Not supported on iOS.

TwoWeeks

TwoWeeks: "twoWeeks";

Source: undefined

Week

Week: "week";

Source: undefined

Year

Year: "year";

Source: undefined

---

Visibility

Source: undefined

Enumeration Members

Private

Private: 0;

Source: undefined

Public

Public: 1;

Source: undefined

Secret

Secret: -1;

Source: undefined

Classes

Schedule

Source: undefined

Constructors

Constructor

new Schedule(): Schedule;

Returns

Schedule

Properties

Property	Type	Defined in
at	| { allowWhileIdle: boolean; date: Date; repeating: boolean; } | undefined	Source: undefined
every	| { allowWhileIdle: boolean; count: number; interval: ScheduleEvery; } | undefined	Source: undefined
interval	| { allowWhileIdle: boolean; interval: ScheduleInterval; } | undefined	Source: undefined

Methods

at()

static at(
   date,
   repeating?,
   allowWhileIdle?
): Schedule;

Source: undefined

Parameters

Parameter	Type	Default value
date	Date	undefined
repeating	boolean	false
allowWhileIdle	boolean	false

Returns

Schedule

every()

static every(
   kind,
   count,
   allowWhileIdle?
): Schedule;

Source: undefined

Parameters

Parameter	Type	Default value
kind	ScheduleEvery	undefined
count	number	undefined
allowWhileIdle	boolean	false

Returns

Schedule

interval()

static interval(interval, allowWhileIdle?): Schedule;

Source: undefined

Parameters

Parameter	Type	Default value
interval	ScheduleInterval	undefined
allowWhileIdle	boolean	false

Returns

Schedule

Interfaces

Action

Source: undefined

Properties

Property	Type	Defined in
destructive?	boolean	Source: undefined
foreground?	boolean	Source: undefined
id	string	Source: undefined
input?	boolean	Source: undefined
inputButtonTitle?	string	Source: undefined
inputPlaceholder?	string	Source: undefined
requiresAuthentication?	boolean	Source: undefined
title	string	Source: undefined

---

ActionType

Source: undefined

Properties

Property	Type	Description	Defined in
actions	Action[]	The list of associated actions	Source: undefined
allowInCarPlay?	boolean	-	Source: undefined
customDismissAction?	boolean	-	Source: undefined
hiddenPreviewsBodyPlaceholder?	string	-	Source: undefined
hiddenPreviewsShowSubtitle?	boolean	-	Source: undefined
hiddenPreviewsShowTitle?	boolean	-	Source: undefined
id	string	The identifier of this action type	Source: undefined

---

ActiveNotification

Source: undefined

Properties

Property	Type	Defined in
actionTypeId?	string	Source: undefined
attachments	Attachment[]	Source: undefined
body?	string	Source: undefined
data	Record<string, string>	Source: undefined
extra	Record<string, unknown>	Source: undefined
group?	string	Source: undefined
groupSummary	boolean	Source: undefined
id	number	Source: undefined
schedule?	Schedule	Source: undefined
sound?	string	Source: undefined
tag?	string	Source: undefined
title?	string	Source: undefined

---

Attachment

Source: undefined

Attachment of a notification.

Properties

Property	Type	Description	Defined in
id	string	Attachment identifier.	Source: undefined
url	string	Attachment URL. Accepts the asset and file protocols.	Source: undefined

---

Channel

Source: undefined

Properties

Property	Type	Defined in
description?	string	Source: undefined
id	string	Source: undefined
importance?	Importance	Source: undefined
lightColor?	string	Source: undefined
lights?	boolean	Source: undefined
name	string	Source: undefined
sound?	string	Source: undefined
vibration?	boolean	Source: undefined
visibility?	Visibility	Source: undefined

---

Options

Source: undefined

Options to send a notification.

Since

2.0.0

Properties

Property	Type	Description	Defined in
actionTypeId?	string	Defines an action type for this notification.	Source: undefined
attachments?	Attachment[]	Notification attachments.	Source: undefined
autoCancel?	boolean	Automatically cancel the notification when the user clicks on it.	Source: undefined
body?	string	Optional notification body.	Source: undefined
channelId?	string	Identifier of the Channel that deliveres this notification. If the channel does not exist, the notification won’t fire. Make sure the channel exists with listChannels and createChannel.	Source: undefined
extra?	Record<string, unknown>	Extra payload to store in the notification.	Source: undefined
group?	string	Identifier used to group multiple notifications. https://developer.apple.com/documentation/usernotifications/unmutablenotificationcontent/1649872-threadidentifier	Source: undefined
groupSummary?	boolean	Instructs the system that this notification is the summary of a group on Android.	Source: undefined
icon?	string	Notification icon. On Android the icon must be placed in the app’s res/drawable folder.	Source: undefined
iconColor?	string	Icon color on Android.	Source: undefined
id?	number	The notification identifier to reference this object later. Must be a 32-bit integer.	Source: undefined
inboxLines?	string[]	List of lines to add to the notification. Changes the notification style to inbox. Cannot be used with largeBody. Only supports up to 5 lines.	Source: undefined
largeBody?	string	Multiline text. Changes the notification style to big text. Cannot be used with inboxLines.	Source: undefined
largeIcon?	string	Notification large icon (Android). The icon must be placed in the app’s res/drawable folder.	Source: undefined
number?	number	Sets the number of items this notification represents on Android.	Source: undefined
ongoing?	boolean	If true, the notification cannot be dismissed by the user on Android. An application service must manage the dismissal of the notification. It is typically used to indicate a background task that is pending (e.g. a file download) or the user is engaged with (e.g. playing music).	Source: undefined
schedule?	Schedule	Schedule this notification to fire on a later time or a fixed interval.	Source: undefined
silent?	boolean	Changes the notification presentation to be silent on iOS (no badge, no sound, not listed).	Source: undefined
sound?	string	The sound resource name or file path for the notification. ## Platform-specific behavior: - On macOS: use system sounds (e.g., “Ping”, “Blow”) or sound files in the app bundle - On Linux: use XDG theme sounds (e.g., “message-new-instant”) or file paths - On Windows: use file paths to sound files (.wav format) - On Mobile: use resource names	Source: undefined
summary?	string	Detail text for the notification with largeBody, inboxLines or groupSummary.	Source: undefined
title	string	Notification title.	Source: undefined
visibility?	Visibility	Notification visibility.	Source: undefined

---

PendingNotification

Source: undefined

Properties

Property	Type	Defined in
body?	string	Source: undefined
id	number	Source: undefined
schedule	Schedule	Source: undefined
title?	string	Source: undefined

---

ScheduleInterval

Source: undefined

Properties

Property	Type	Description	Defined in
day?	number	-	Source: undefined
hour?	number	-	Source: undefined
minute?	number	-	Source: undefined
month?	number	-	Source: undefined
second?	number	-	Source: undefined
weekday?	number	1 - Sunday 2 - Monday 3 - Tuesday 4 - Wednesday 5 - Thursday 6 - Friday 7 - Saturday	Source: undefined
year?	number	-	Source: undefined

Type Aliases

PermissionState

type PermissionState = "granted" | "denied" | "prompt" | "prompt-with-rationale";

Source: undefined

Functions

active()

function active(): Promise<ActiveNotification[]>;

Source: undefined

Retrieves the list of active notifications.

Returns

Promise<ActiveNotification[]>

A promise resolving to the list of active notifications.

Example

import { active } from '@tauri-apps/plugin-notification';
const activeNotifications = await active();

Since

2.0.0

---

cancel()

function cancel(notifications): Promise<void>;

Source: undefined

Cancels the pending notifications with the given list of identifiers.

Parameters

Parameter	Type
notifications	number[]

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { cancel } from '@tauri-apps/plugin-notification';
await cancel([-34234, 23432, 4311]);

Since

2.0.0

---

cancelAll()

function cancelAll(): Promise<void>;

Source: undefined

Cancels all pending notifications.

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { cancelAll } from '@tauri-apps/plugin-notification';
await cancelAll();

Since

2.0.0

---

channels()

function channels(): Promise<Channel[]>;

Source: undefined

Retrieves the list of notification channels.

Returns

Promise<Channel[]>

A promise resolving to the list of notification channels.

Example

import { channels } from '@tauri-apps/plugin-notification';
const notificationChannels = await channels();

Since

2.0.0

---

createChannel()

function createChannel(channel): Promise<void>;

Source: undefined

Creates a notification channel.

Parameters

Parameter	Type
channel	Channel

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { createChannel, Importance, Visibility } from '@tauri-apps/plugin-notification';
await createChannel({
  id: 'new-messages',
  name: 'New Messages',
  lights: true,
  vibration: true,
  importance: Importance.Default,
  visibility: Visibility.Private
});

Since

2.0.0

---

isPermissionGranted()

function isPermissionGranted(): Promise<boolean>;

Source: undefined

Checks if the permission to send notifications is granted.

Returns

Promise<boolean>

Example

import { isPermissionGranted } from '@tauri-apps/plugin-notification';
const permissionGranted = await isPermissionGranted();

Since

2.0.0

---

onAction()

function onAction(cb): Promise<PluginListener>;

Source: undefined

Parameters

Parameter	Type
cb	(notification) => void

Returns

Promise<PluginListener>

---

onNotificationReceived()

function onNotificationReceived(cb): Promise<PluginListener>;

Source: undefined

Parameters

Parameter	Type
cb	(notification) => void

Returns

Promise<PluginListener>

---

pending()

function pending(): Promise<PendingNotification[]>;

Source: undefined

Retrieves the list of pending notifications.

Returns

Promise<PendingNotification[]>

A promise resolving to the list of pending notifications.

Example

import { pending } from '@tauri-apps/plugin-notification';
const pendingNotifications = await pending();

Since

2.0.0

---

registerActionTypes()

function registerActionTypes(types): Promise<void>;

Source: undefined

Register actions that are performed when the user clicks on the notification.

Parameters

Parameter	Type
types	ActionType[]

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { registerActionTypes } from '@tauri-apps/plugin-notification';
await registerActionTypes([{
  id: 'tauri',
  actions: [{
    id: 'my-action',
    title: 'Settings'
  }]
}])

Since

2.0.0

---

removeActive()

function removeActive(notifications): Promise<void>;

Source: undefined

Removes the active notifications with the given list of identifiers.

Parameters

Parameter	Type
notifications	object[]

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { cancel } from '@tauri-apps/plugin-notification';
await cancel([-34234, 23432, 4311])

Since

2.0.0

---

removeAllActive()

function removeAllActive(): Promise<void>;

Source: undefined

Removes all active notifications.

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { removeAllActive } from '@tauri-apps/plugin-notification';
await removeAllActive()

Since

2.0.0

---

removeChannel()

function removeChannel(id): Promise<void>;

Source: undefined

Removes the channel with the given identifier.

Parameters

Parameter	Type
id	string

Returns

Promise<void>

A promise indicating the success or failure of the operation.

Example

import { removeChannel } from '@tauri-apps/plugin-notification';
await removeChannel();

Since

2.0.0

---

requestPermission()

function requestPermission(): Promise<NotificationPermission>;

Source: undefined

Requests the permission to send notifications.

Returns

Promise<NotificationPermission>

A promise resolving to whether the user granted the permission or not.

Example

import { isPermissionGranted, requestPermission } from '@tauri-apps/plugin-notification';
let permissionGranted = await isPermissionGranted();
if (!permissionGranted) {
  const permission = await requestPermission();
  permissionGranted = permission === 'granted';
}

Since

2.0.0

---

sendNotification()

function sendNotification(options): void;

Source: undefined

Sends a notification to the user.

Parameters

Parameter	Type
options	string | Options

Returns

void

Example

import { isPermissionGranted, requestPermission, sendNotification } from '@tauri-apps/plugin-notification';
let permissionGranted = await isPermissionGranted();
if (!permissionGranted) {
  const permission = await requestPermission();
  permissionGranted = permission === 'granted';
}
if (permissionGranted) {
  sendNotification('Tauri is awesome!');
  sendNotification({ title: 'TAURI', body: 'Tauri is awesome!' });
}

Since

2.0.0