WebSocket

API Reference

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

支持的平台

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
windows
linux
macos
android
ios

设置

首先安装 WebSocket 插件。

自动
手动

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

npm run tauri add websocket

yarn run tauri add websocket

pnpm tauri add websocket

bun tauri add websocket

cargo tauri add websocket

在你的 Cargo.toml 文件中添加以下内容来安装 websocket 插件。

[dependencies]
tauri-plugin-websocket = "2.0.0"
# 或者使用 Git：
tauri-plugin-websocket = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "v2" }

修改 lib.rs 来初始化插件。

fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_websocket::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

使用你喜欢的 JavaScript 包管理器安装 JavaScript Guest 绑定。

npm install @tauri-apps/plugin-websocket

yarn add @tauri-apps/plugin-websocket

pnpm add @tauri-apps/plugin-websocket

bun add @tauri-apps/plugin-websocket

用法

WebSocket 插件可以在 JavaScript 中使用。

import WebSocket from '@tauri-apps/plugin-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 配置中定义一个权限列表。

更多信息请参见访问控制列表。

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

权限	描述
`websocket:default`	允许连接和发送数据到 WebSocket 服务器
`websocket:allow-connect`	在没有预先配置的作用域的情况下启用 connect 命令。
`websocket:deny-connect`	拒绝没有任何预配置范围的 connect 命令。
`websocket:allow-send`	在没有预先配置的作用域的情况下启用 send 命令。
`websocket:deny-send`	拒绝没有任何预配置范围的 send 命令。