跳到内容
Tauri

Websocket

在 JavaScript 中使用 Rust 客户端打开 WebSocket 连接。

此插件需要 Rust 版本至少为 **1.77.2**

平台 级别 备注
Windows
Linux
macOS
Android
iOS

安装 WebSocket 插件即可开始使用。

使用你的项目包管理器添加依赖项

npm run tauri add websocket

Websocket 插件在 JavaScript 中可用。

import WebSocket from '@tauri-apps/plugin-websocket';
// when using `"withGlobalTauri": true`, you may use
// const WebSocket = window.__TAURI__.websocket;
const ws = await WebSocket.connect('ws://127.0.0.1:8080');
ws.addListener((msg) => {
console.log('Received Message:', msg);
});
await ws.send('Hello World!');
await ws.disconnect();

默认情况下,所有潜在危险的插件命令和范围都被阻止,无法访问。您必须修改 capabilities 配置中的权限才能启用这些功能。

有关更多信息,请参阅功能概述,并参阅分步指南以使用插件权限。

src-tauri/capabilities/default.json
{
"$schema": "../gen/schemas/desktop-schema.json",
"identifier": "main-capability",
"description": "Capability for the main window",
"windows": ["main"],
"permissions": ["websocket:default"]
}

默认权限

允许连接和发送数据到 WebSocket 服务器

此默认权限集包括以下内容

  • allow-connect
  • allow-send

权限表

标识符 描述

websocket:allow-connect

启用 connect 命令,不预设任何作用域。

websocket:deny-connect

拒绝 connect 命令,不预设任何作用域。

websocket:allow-send

启用 send 命令,不预设任何作用域。

websocket:deny-send

拒绝 send 命令,不预设任何作用域。


© 2025 Tauri 贡献者。CC-BY / MIT