Enum EventLoopHandle 

pub enum EventLoopHandle {
    Js {
        owner: JsEventLoop,
    },
    Mini(BackRef<MiniEventLoop<'static>>),
}

Variants

Js

Fields

owner: JsEventLoop

Typed handle wrapping the erased *mut jsc::EventLoop — see AnyEventLoop::Js. JsEventLoop is Copy, so the handle stays Copy.

Mini(BackRef<MiniEventLoop<'static>>)

Implementations

impl EventLoopHandle

pub fn init(js_event_loop: *mut ()) -> EventLoopHandle

Wrap an erased *mut jsc::EventLoop.

js_event_loop is a live erased *mut jsc::EventLoop whose owner outlives every dispatch through the returned handle. The pointer is not dereferenced here — it’s stored opaquely in JsEventLoop and only dereferenced at dispatch sites. A null pointer is a documented sentinel for “never dispatched” placeholders (e.g. struct field initialisers that are overwritten before use).

pub fn init_mini(mini: *mut MiniEventLoop<'static>) -> EventLoopHandle

pub fn as_event_loop_ctx(self) -> EventLoopCtx

pub fn into_tag_ptr(self) -> (i8, *mut c_void)

Erase to the (tag, ptr) pair stored in uws::InternalLoopData (parent_tag / parent_ptr). Tag 1 = JS, tag 2 = mini — matches Zig setParentEventLoop.

pub unsafe fn from_tag_ptr(tag: i8, ptr: *mut c_void) -> EventLoopHandle

Inverse of [into_tag_ptr] — recover from the (tag, ptr) pair stored in uws::InternalLoopData (Zig: loop.internal_loop_data.getParent()).

(tag, ptr) must have been produced by [into_tag_ptr] on a still-live event loop (i.e. read from internal_loop_data while the loop is alive).

Safety

(tag, ptr) must have been produced by [into_tag_ptr] on a still-live event loop. The constructor itself only stores the opaque pointer, but dispatch through the resulting handle dereferences it — this fn is the last place the precondition can be discharged. (NOT eligible for unsafe-fn-narrow: the invariant is caller-provided, not internally guarded.)

impl EventLoopHandle

pub fn set_as_parent_of(self, uws_loop: &mut PosixLoop)

Zig: loop.internal_loop_data.setParentEventLoop(jsc.EventLoopHandle.init(..)). Convenience wrapper so callers don’t need both bun_uws::InternalLoopDataExt (the trait) and the *mut Loop deref dance in scope. uws_loop is the process-global loop returned by AnyEventLoop::r#loop() — never null.

pub fn from_any(any: &mut AnyEventLoop<'static>) -> EventLoopHandle

pub fn js_current() -> EventLoopHandle

EventLoopHandle for the current thread’s JS event loop. Replaces jsc::EventLoopHandle.init(jsc::VirtualMachine.get()) for tier-≤4 callers.

pub fn global_object(self) -> *mut ()

Erased *mut jsc::JSGlobalObject or null (Mini has no JS global).

pub fn bun_vm(self) -> *mut ()

Erased *mut jsc::VirtualMachine or null.

pub fn stdout(self) -> *mut ()

Erased *mut webcore::blob::Store.

pub fn stderr(self) -> *mut ()

Erased *mut webcore::blob::Store.

pub fn enter(self)

pub fn exit(self)

pub fn entered(self) -> EnteredEventLoop

enter() and return an RAII guard that exit()s on drop. Prefer this over a bare enter()/exit() pair so early returns and ? don’t leak the entered scope.

pub fn file_polls(self) -> *mut Store

Returns the FilePoll store as a raw pointer (mirrors Zig *FilePoll.Store). EventLoopHandle is Copy; promoting to &'static mut would let two calls produce aliased exclusive references (UB). Callers deref locally for the brief region they need &mut.

pub fn put_file_poll(&mut self, poll: &mut FilePoll)

pub fn enqueue_task_concurrent(self, task: EventLoopTaskPtr)

pub fn loop(self) -> *mut PosixLoop

pub fn platform_event_loop(self) -> *mut PosixLoop

pub fn loop_(self) -> *mut PosixLoop

Alias for r#loop so callers spell handle.loop_() without the raw-identifier escape (Zig: handle.loop()).

pub fn native_loop(self) -> *mut PosixLoop

Platform-native loop pointer (us_loop_t* on POSIX, uv_loop_t* on Windows). See bun_io::uws_to_native — collapses the per-site #[cfg(windows)] .uv_loop projection that previously appeared at every BufferedReaderParent::loop_ impl.

pub fn pipe_read_buffer(self) -> *mut [u8]

Returns the shared pipe-read scratch buffer as a raw fat ptr (mirrors Zig []u8). Same Copy-handle aliasing concern as [file_polls].

pub fn ref_(self)

pub fn unref(self)

pub fn env(self) -> *mut Loader<'static>

pub fn top_level_dir(self) -> &'static [u8]

pub fn create_null_delimited_env_map( self, ) -> Result<NullDelimitedEnvMap, AllocError>

Trait Implementations

impl Clone for EventLoopHandle

fn clone(&self) -> EventLoopHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for EventLoopHandle

impl ParentEventLoopHandle for EventLoopHandle

Carrier-trait impl so bun_uws::InternalLoopDataExt::set_parent_event_loop accepts EventLoopHandle directly. Kept here (not in bun_uws) because bun_uws is a lower tier than bun_event_loop and cannot name this enum.

fn into_tag_ptr(self) -> (i8, *mut c_void)