deno_runtime 0.261.0

Provides the deno runtime library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

// Copyright 2018-2026 the Deno authors. MIT license.

mod sync_fetch;

use std::cell::RefCell;
use std::rc::Rc;

use deno_core::CancelFuture;
use deno_core::DetachedBuffer;
use deno_core::JsBuffer;
use deno_core::JsRuntimeInspector;
use deno_core::OpState;
use deno_core::op2;
use deno_web::JsMessageData;
use deno_web::MessagePortError;
pub use sync_fetch::SyncFetchError;

use self::sync_fetch::op_worker_sync_fetch;
use crate::web_worker::WebWorkerInternalHandle;
use crate::web_worker::WorkerControlEvent;
use crate::web_worker::WorkerThreadType;

deno_core::extension!(
  deno_web_worker,
  ops = [
    op_worker_post_message,
    op_worker_post_message_raw,
    op_worker_recv_message,
    op_worker_recv_message_sync,
    op_worker_maybe_wait_for_debugger,
    // Notify host that guest worker closes.
    op_worker_close,
    op_worker_get_type,
    op_worker_sync_fetch,
  ],
);

pub struct WaitForWorkerDebuggerOnMessage(pub bool);

#[op2]
fn op_worker_post_message(
  state: &mut OpState,
  #[serde] data: JsMessageData,
) -> Result<(), MessagePortError> {
  let handle = state.borrow::<WebWorkerInternalHandle>().clone();
  handle.port.send(state, data)
}

/// Fast-path post: takes a pre-serialized buffer directly, bypassing
/// the JsMessageData serde overhead. Only for messages with no transferables.
#[op2]
fn op_worker_post_message_raw(
  state: &mut OpState,
  #[buffer(detach)] data: JsBuffer,
) -> Result<(), MessagePortError> {
  let handle = state.borrow::<WebWorkerInternalHandle>().clone();
  let detached = DetachedBuffer::from_v8slice(data.into_parts());
  if let Some(tx) = &*handle.port.tx.borrow() {
    tx.send((detached, vec![])).ok();
  }
  Ok(())
}

#[op2(async(lazy), fast)]
async fn op_worker_recv_message(
  state: Rc<RefCell<OpState>>,
) -> Result<Option<JsMessageData>, MessagePortError> {
  let handle = {
    let state = state.borrow();
    state.borrow::<WebWorkerInternalHandle>().clone()
  };
  handle
    .port
    .recv(state.clone())
    .or_cancel(handle.cancel)
    .await?
}

#[op2]
fn op_worker_recv_message_sync(
  state: &mut OpState,
) -> Result<Option<JsMessageData>, MessagePortError> {
  let handle = state.borrow::<WebWorkerInternalHandle>().clone();
  handle.port.try_recv_sync(state)
}

#[op2(fast)]
fn op_worker_maybe_wait_for_debugger(state: &mut OpState) {
  let should_wait = state
    .try_borrow_mut::<WaitForWorkerDebuggerOnMessage>()
    .map(|wait| {
      let should_wait = wait.0;
      wait.0 = false;
      should_wait
    })
    .unwrap_or(false);
  if !should_wait {
    return;
  }

  if let Some(inspector) = state.try_borrow::<Rc<JsRuntimeInspector>>() {
    inspector.wait_for_debugger_enabled_for_worker_message();
  }
}

#[op2(fast)]
fn op_worker_close(state: &mut OpState) {
  // Notify parent that we're finished
  let exit_code = state
    .try_borrow::<deno_os::ExitCode>()
    .map(|e| e.get())
    .unwrap_or(0);
  let mut handle = state.borrow_mut::<WebWorkerInternalHandle>().clone();

  // Send the exit code to the parent before terminating
  let _ = handle.post_event(WorkerControlEvent::Close(exit_code));
  handle.terminate();
}

#[op2]
fn op_worker_get_type(state: &mut OpState) -> WorkerThreadType {
  let handle = state.borrow::<WebWorkerInternalHandle>().clone();
  handle.worker_type
}