Rust Web工具库deno_web的使用：Deno运行时中的Web API实现与浏览器兼容性支持

deno_web是一个Rust库，它为Deno运行时实现了多种Web API，包括定时器和以下API：

• Event
• TextEncoder
• TextDecoder
• File (遵循W3C FileAPI规范)

使用示例

从JavaScript中，可以这样引入扩展的源代码：

import * as infra from "ext:deno_web/00_infra.js";
import * as DOMException from "ext:deno_web/01_dom_exception.js";
import * as mimesniff from "ext:deno_web/01_mimesniff.js";
import * as event from "ext:deno_web/02_event.js";
import * as structuredClone from "ext:deno_web/02_structured_clone.js";
import * as timers from "ext:deno_web/02_timers.js";
import * as abortSignal from "ext:deno_web/03_abort_signal.js";
import * as globalInterfaces from "ext:deno_web/04_global_interfaces.js";
import * as base64 from "ext:deno_web/05_base64.js";
import * as streams from "ext:deno_web/06_streams.js";
import * as encoding from "ext:deno_web/08_text_encoding.js";
import * as file from "ext:deno_web/09_file.js";
import * as fileReader from "ext:deno_web/10_filereader.js";
import * as location from "ext:deno_web/12_location.js";
import * as messagePort from "ext:deno_web/13_message_port.js";
import * as compression from "ext:deno_web/14_compression.js";
import * as performance from "ext:deno_web/15_performance.js";
import * as imageData from "ext:deno_web/16_image_data.js";

然后将以下属性分配给全局作用域，例如：

Object.defineProperty(globalThis, "AbortController", {
  value: abortSignal.AbortController,
  enumerable: false,
  configurable: true,
  writable: true,
});

Rust端集成

在Rust中，需要在RuntimeOptions的extensions字段中提供：

deno_web::deno_web::init::<Permissions>(Arc<BlobStore>, Option<Url>)

其中：

• Permissions 是实现 deno_web::TimersPermission 的结构体
• Arc<BlobStore> 可以通过 Default::default() 提供
• Option<Url> 为某些操作提供可选的基准URL

完整示例

下面是一个完整的Deno扩展示例，展示如何使用deno_web提供的Web API：

use deno_core::Extension;
use deno_web::BlobStore;
use std::sync::Arc;

// 定义权限结构体
struct WebPermissions;

impl deno_web::TimersPermission for WebPermissions {
    fn allow_hrtime(&self) -> bool {
        true
    }
}

// 创建Deno扩展
pub fn init() -> Extension {
    Extension::builder()
        .js(include_js_files!(
            prefix "deno:ext/web",
            "00_infra.js",
            "01_dom_exception.js",
            // 其他JS文件...
        ))
        .ops(vec![
            // 注册操作...
        ])
        .state(|state| {
            // 初始化deno_web
            state.put(deno_web::deno_web::init::<WebPermissions>(
                Arc::new(BlobStore::default()),
                None,
            ));
            Ok(())
        })
        .build()
}

// 在运行时中使用
let mut runtime = deno_core::JsRuntime::new(deno_core::RuntimeOptions {
    extensions: vec![init()],
    ..Default::default()
});

JavaScript端使用示例：

// 使用TextEncoder API
const encoder = new TextEncoder();
const data = encoder.encode("Hello Deno!");

// 使用定时器API
setTimeout(() => {
    console.log("Timeout fired after 1 second");
}, 1000);

// 使用File API
const file = new File(["file content"], "example.txt", {
    type: "text/plain",
    lastModified: Date.now()
});

// 使用Event API
const event = new Event("customEvent");
const target = new EventTarget();
target.addEventListener("customEvent", () => {
    console.log("Custom event received");
});
target.dispatchEvent(event);

依赖项

• deno_webidl: 由deno_webidl crate提供
• deno_console: 由deno_console crate提供
• deno_url: 由deno_url crate提供

deno_web提供了完整的Web API实现，使Deno运行时能够保持与浏览器的兼容性，同时利用Rust的性能优势。

完整示例demo

以下是一个更完整的Deno扩展实现示例，包含Rust和JavaScript的完整交互：

use deno_core::{Extension, JsRuntime, RuntimeOptions};
use deno_web::BlobStore;
use std::sync::Arc;

// 定义权限结构体
#[derive(Clone)]
struct WebPermissions;

impl deno_web::TimersPermission for WebPermissions {
    fn allow_hrtime(&self) -> bool {
        true
    }
}

// 创建Deno扩展
pub fn create_web_ext() -> Extension {
    Extension::builder()
        .js(include_js_files!(
            prefix "deno:ext/web",
            "00_infra.js",
            "01_dom_exception.js",
            "01_mimesniff.js",
            "02_event.js",
            "02_structured_clone.js",
            "02_timers.js",
            "03_abort_signal.js",
            "04_global_interfaces.js",
            "05_base64.js",
            "06_streams.js",
            "08_text_encoding.js",
            "09_file.js",
            "10_filereader.js",
            "12_location.js",
            "13_message_port.js",
            "14_compression.js",
            "15_performance.js",
            "16_image_data.js"
        ))
        .state(|state| {
            // 初始化deno_web模块
            state.put(deno_web::deno_web::init::<WebPermissions>(
                Arc::new(BlobStore::default()),
                None,
            ));
            Ok(())
        })
        .build()
}

fn main() {
    // 创建运行时
    let mut runtime = JsRuntime::new(RuntimeOptions {
        extensions: vec![create_web_ext()],
        ..Default::default()
    });

    // 执行JavaScript代码
    let js_code = r#"
        // 使用TextEncoder
        const encoder = new TextEncoder();
        const data = encoder.encode("Hello from Rust!");
        console.log(data);
        
        // 使用定时器
        setTimeout(() => {
            console.log("Timer executed after 2 seconds");
        }, 2000);
        
        // 创建并触发自定义事件
        const event = new Event('rustEvent');
        const target = new EventTarget();
        target.addEventListener('rustEvent', () => {
            console.log('Event received from Rust!');
        });
        target.dispatchEvent(event);
    "#;

    runtime.execute_script("<anon>", js_code).unwrap();
}

JavaScript端完整使用示例：

// 初始化Web API
import * as timers from "ext:deno_web/02_timers.js";
import * as event from "ext:deno_web/02_event.js";
import * as encoding from "ext:deno_web/08_text_encoding.js";

// 将API添加到全局作用域
Object.defineProperty(globalThis, "setTimeout", {
  value: timers.setTimeout,
  enumerable: true,
  configurable: true,
  writable: true
});

Object.defineProperty(globalThis, "TextEncoder", {
  value: encoding.TextEncoder,
  enumerable: true,
  configurable: true,
  writable: true
});

Object.defineProperty(globalThis, "Event", {
  value: event.Event,
  enumerable: true,
  configurable: true,
  writable: true
});

// 使用API
const encoder = new TextEncoder();
const data = encoder.encode("Hello World");
console.log("Encoded data:", data);

setTimeout(() => {
  console.log("This message appears after 1 second");
}, 1000);

const customEvent = new Event("myEvent");
document.addEventListener("myEvent", () => {
  console.log("Custom event triggered");
});
document.dispatchEvent(customEvent);

这个完整示例展示了如何在Rust中初始化deno_web扩展，并在JavaScript中使用提供的Web API。示例包含了定时器、文本编码和事件系统的基本用法，演示了deno_web如何为Deno运行时提供浏览器兼容的Web API功能。