Skip to main content

Native events (NativeEventEmitter)

Workers can subscribe to native device events with the familiar NativeEventEmitter API, so a background worker can react to native notifications — geolocation, bluetooth, custom module events — without involving the JS thread.

Subscribing inside a worker​

const worker = new Worker({
  inline: `
    const emitter = new NativeEventEmitter(); // or new NativeEventEmitter(someModule)
    const sub = emitter.addListener('LocationChanged', (payload) => {
      // this fires INSIDE the worker
      self.postMessage({ location: payload });
    });
    // sub.remove(); // when done
  `,
});

worker.onmessage = (e) => console.log('worker saw event:', e.data);

The API mirrors React Native's: addListener(type, cb) returns a subscription with .remove(); removeAllListeners(type) and listenerCount(type) are available too.

How delivery works​

There are two paths, matching how React Native itself routes events:

  • C++ (Cxx) module events are emitted through the worker's own CallInvoker, so they land directly on the worker.
  • Java/Objective-C module events — and anything emitted through the app's DeviceEventEmitter — are emitted on the host runtime. The library forwards those to any worker that has registered a listener (the event payload is structured-cloned).

You don't have to think about which path an event takes; subscribing is the same.

Example: forwarding an app event to a worker​

import { DeviceEventEmitter } from 'react-native';

const worker = new Worker({
  inline: `
    new NativeEventEmitter().addListener('sync-requested', (p) => {
      self.postMessage({ started: p.id });
      // ...do the sync work here, off the JS thread...
    });
  `,
});

// somewhere in your app, on the JS thread:
DeviceEventEmitter.emit('sync-requested', { id: 42 });

Notes​

  • A worker only receives forwarded host events after it has added at least one listener (it opts in on first addListener). Workers with no listeners cost nothing.
  • Event payloads must be structured-cloneable to reach a worker; non-cloneable payloads are delivered to the host only.