core
此内容尚不支持你的语言。
Invoke your custom commands.
This package is also accessible with window.__TAURI__.tauri
when app.withGlobalTauri
in tauri.conf.json
is set to true
.
Classes
Channel<T>
Type Parameters
Type Parameter | Default type |
---|---|
T | unknown |
Constructors
new Channel()
new Channel<T>(): Channel<T>
Returns
Channel
<T
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L37
Properties
Property | Type | Defined in |
---|---|---|
id | number | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L28 |
Accessors
onmessage
get onmessage(): (response) => void
set onmessage(handler): void
Parameters
Parameter | Type |
---|---|
handler | (response ) => void |
Returns
Function
Parameters
Parameter | Type |
---|---|
response | T |
Returns
void
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L79
Methods
toJSON()
toJSON(): string
Returns
string
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L83
PluginListener
Constructors
new PluginListener()
new PluginListener( plugin, event, channelId): PluginListener
Parameters
Parameter | Type |
---|---|
plugin | string |
event | string |
channelId | number |
Returns
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L93
Properties
Property | Type | Defined in |
---|---|---|
channelId | number | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L91 |
event | string | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L90 |
plugin | string | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L89 |
Methods
unregister()
unregister(): Promise<void>
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L99
Resource
A rust-backed resource stored through tauri::Manager::resources_table
API.
The resource lives in the main process and does not exist
in the Javascript world, and thus will not be cleaned up automatiacally
except on application exit. If you want to clean it up early, call Resource.close
Example
import { Resource, invoke } from '@tauri-apps/api/core';export class DatabaseHandle extends Resource { static async open(path: string): Promise<DatabaseHandle> { const rid: number = await invoke('open_db', { path }); return new DatabaseHandle(rid); }
async execute(sql: string): Promise<void> { await invoke('execute_sql', { rid: this.rid, sql }); }}
Extended by
Constructors
new Resource()
new Resource(rid): Resource
Parameters
Parameter | Type |
---|---|
rid | number |
Returns
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L246
Accessors
rid
get rid(): number
Returns
number
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L242
Methods
close()
close(): Promise<void>
Destroys and cleans up this resource from memory. You should not call any method on this object anymore and should drop any reference to it.
Returns
Promise
<void
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L254
Interfaces
InvokeOptions
Since
2.0.0
Properties
Property | Type | Defined in |
---|---|---|
headers | Headers | Record <string , string > | Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L157 |
Type Aliases
InvokeArgs
type InvokeArgs: Record<string, unknown> | number[] | ArrayBuffer | Uint8Array;
Command arguments.
Since
1.0.0
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L151
PermissionState
type PermissionState: "granted" | "denied" | "prompt" | "prompt-with-rationale";
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L126
Functions
addPluginListener()
function addPluginListener<T>( plugin, event,cb): Promise<PluginListener>
Adds a listener to a plugin event.
Type Parameters
Type Parameter |
---|
T |
Parameters
Parameter | Type |
---|---|
plugin | string |
event | string |
cb | (payload ) => void |
Returns
The listener object to stop listening to the events.
Since
2.0.0
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L114
checkPermissions()
function checkPermissions<T>(plugin): Promise<T>
Get permission state for a plugin.
This should be used by plugin authors to wrap their actual implementation.
Type Parameters
Type Parameter |
---|
T |
Parameters
Parameter | Type |
---|---|
plugin | string |
Returns
Promise
<T
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L133
convertFileSrc()
function convertFileSrc(filePath, protocol): string
Convert a device file path to an URL that can be loaded by the webview.
Note that asset:
and http://asset.localhost
must be added to tauri.security.csp
in tauri.conf.json
.
Example CSP value: "csp": "default-src 'self' ipc: http://ipc.localhost; img-src 'self' asset: http://asset.localhost"
to use the asset protocol on image sources.
Additionally, asset
must be added to tauri.allowlist.protocol
in tauri.conf.json
and its access scope must be defined on the assetScope
array on the same protocol
object.
Parameters
Parameter | Type | Default value | Description |
---|---|---|---|
filePath | string | undefined | The file path. |
protocol | string | 'asset' | The protocol to use. Defaults to asset . You only need to set this when using a custom protocol. |
Returns
string
the URL that can be used as source on the webview.
Example
import { appDataDir, join } from '@tauri-apps/api/path';import { convertFileSrc } from '@tauri-apps/api/core';const appDataDirPath = await appDataDir();const filePath = await join(appDataDirPath, 'assets/video.mp4');const assetUrl = convertFileSrc(filePath);
const video = document.getElementById('my-video');const source = document.createElement('source');source.type = 'video/mp4';source.src = assetUrl;video.appendChild(source);video.load();
Since
1.0.0
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L213
invoke()
function invoke<T>( cmd, args,options?): Promise<T>
Sends a message to the backend.
Type Parameters
Type Parameter |
---|
T |
Parameters
Parameter | Type | Description |
---|---|---|
cmd | string | The command name. |
args | InvokeArgs | The optional arguments to pass to the command. |
options ? | InvokeOptions | The request options. |
Returns
Promise
<T
>
A promise resolving or rejecting to the backend response.
Example
import { invoke } from '@tauri-apps/api/core';await invoke('login', { user: 'tauri', password: 'poiwe3h4r5ip3yrhtew9ty' });
Since
1.0.0
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L175
isTauri()
function isTauri(): boolean
Returns
boolean
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L261
requestPermissions()
function requestPermissions<T>(plugin): Promise<T>
Request permissions.
This should be used by plugin authors to wrap their actual implementation.
Type Parameters
Type Parameter |
---|
T |
Parameters
Parameter | Type |
---|---|
plugin | string |
Returns
Promise
<T
>
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L142
transformCallback()
function transformCallback<T>(callback?, once?): number
Transforms a callback function to a string identifier that can be passed to the backend.
The backend uses the identifier to eval()
the callback.
Type Parameters
Type Parameter | Default type |
---|---|
T | unknown |
Parameters
Parameter | Type | Default value |
---|---|---|
callback ? | (response ) => void | undefined |
once ? | boolean | false |
Returns
number
A unique identifier associated with the callback function.
Since
1.0.0
Source: https://github.com/tauri-apps/tauri/blob/dev/packages/api/src/core.ts#L20
© 2024 Tauri Contributors. CC-BY / MIT