@react-native/dev-middleware NPM | npm.io

0.74.83 • Published 1 day ago

Install

Weekly downloads

-

License

MIT

Repository

Last release

1 day ago

@react-native/dev-middleware

npm package

Dev server middleware supporting core React Native development features. This package is preconfigured in all React Native projects.

Usage

Middleware can be attached to a dev server (e.g. Metro) using the createDevMiddleware API.

import { createDevMiddleware } from '@react-native/dev-middleware';

function myDevServerImpl(args) {
  ...

  const {middleware, websocketEndpoints} = createDevMiddleware({
    projectRoot: metroConfig.projectRoot,
    serverBaseUrl: `http://${args.host}:${args.port}`,
    logger,
  });

  await Metro.runServer(metroConfig, {
    host: args.host,
    ...,
    unstable_extraMiddleware: [
      middleware,
      // Optionally extend with additional HTTP middleware
    ],
    websocketEndpoints: {
      ...websocketEndpoints,
      // Optionally extend with additional WebSocket endpoints
    },
  });
}

Included middleware

@react-native/dev-middleware is designed for integrators such as @expo/dev-server and @react-native/community-cli-plugin. It provides a common default implementation for core React Native dev server responsibilities.

We intend to keep this to a narrow set of functionality, based around:

Debugging — The Chrome DevTools protocol (CDP) endpoints supported by React Native, including the Inspector Proxy, which facilitates connections with multiple devices.
Dev actions — Endpoints implementing core Dev Menu actions, e.g. reloading the app, opening the debugger frontend.

HTTP endpoints

DevMiddlewareAPI.middleware

These are exposed as a connect middleware handler, assignable to Metro.runServer or other compatible HTTP servers.

GET `/json/list`, `/json` (CDP)

Returns the list of available WebSocket targets for all connected React Native app sessions.

GET `/json/version` (CDP)

Returns version metadata used by Chrome DevTools.

POST `/open-debugger`

Open the JavaScript debugger for a given CDP target (direct Hermes debugging).

curl -X POST 'http://localhost:8081/open-debugger?appId=com.meta.RNTester'

WebSocket endpoints

DevMiddlewareAPI.websocketEndpoints

`/inspector/device`

WebSocket handler for registering device connections.

`/inspector/debug`

WebSocket handler that proxies CDP messages to/from the corresponding device.

Contributing

Changes to this package can be made locally and tested against the rn-tester app, per the Contributing guide. During development, this package is automatically run from source with no build step.

react-native tools

@isaacs/ttlcache @react-native/debugger-frontend chrome-launcher chromium-edge-launcher connect debug node-fetch nullthrows open selfsigned serve-static temp-dir ws

@everything-registry/sub-chunk-766 @expo/cli @react-native/community-cli-plugin @callstack/repack-dev-server

0.75.0-nightly-20240509-f4996e0b6

1 day ago

0.75.0-nightly-20240508-88ab1ceea

2 days ago

0.75.0-nightly-20240507-be09d1266

3 days ago

0.75.0-nightly-20240505-362abb9ff

5 days ago

0.75.0-nightly-20240506-362abb9ff

4 days ago

0.75.0-nightly-20240505-a881b51fe

6 days ago

0.75.0-nightly-20240504-a881b51fe

6 days ago

0.75.0-nightly-20240503-1d2221ab4

7 days ago

0.75.0-nightly-20240502-88de74b2d

8 days ago

8 days ago

0.75.0-nightly-20240501-90663081d

9 days ago

10 days ago

0.75.0-nightly-20240430-c96c89337

10 days ago

0.75.0-nightly-20240429-b7de91666

11 days ago

0.75.0-nightly-20240428-bb2c13af5

12 days ago

0.75.0-nightly-20240427-e2ad6696d

13 days ago

0.75.0-nightly-20240426-9c4ee6df0

14 days ago

0.75.0-nightly-20240425-2876fae8d

15 days ago

0.75.0-nightly-20240424-132563d81

16 days ago

0.75.0-nightly-20240423-41f525cca

17 days ago

0.75.0-nightly-20240422-876914be5

18 days ago

19 days ago

0.75.0-nightly-20240421-03a51da72

19 days ago

0.75.0-nightly-20240420-03a51da72

20 days ago

0.75.0-nightly-20240419-73b4d67a7

21 days ago

0.75.0-nightly-20240418-4fbc1f2ef

22 days ago

0.75.0-nightly-20240417-fe9942a19

23 days ago

0.75.0-nightly-20240416-8c53ac607

24 days ago

0.75.0-nightly-20240415-e7154bdd9

25 days ago

26 days ago

0.75.0-nightly-20240414-a5eeea814

26 days ago

0.75.0-nightly-20240413-1b152f6ec

27 days ago

0.75.0-nightly-20240412-b72f5e998

28 days ago

0.75.0-nightly-20240411-46b6453eb

29 days ago

0.75.0-nightly-20240409-881c0bc89

1 month ago

1 month ago

0.75.0-nightly-20240410-f7eaf6388

1 month ago

1 month ago

0.75.0-nightly-20240408-eae5d9711

1 month ago

0.75.0-nightly-20240407-592716582

1 month ago

0.75.0-nightly-20240406-a05466c5b

1 month ago

0.75.0-nightly-20240405-3f05ad6e8

1 month ago

0.75.0-nightly-20240404-70c3158b6

1 month ago

0.75.0-nightly-20240403-3559a6c58

1 month ago

1 month ago

0.75.0-nightly-20240331-8769378e0

1 month ago

0.75.0-nightly-20240329-3f8882116

1 month ago

0.75.0-nightly-20240328-af309127a

1 month ago

0.75.0-nightly-20240327-2af1da42f

1 month ago

0.75.0-nightly-20240325-ac714b1c3

2 months ago

2 months ago

0.75.0-nightly-20240323-37e362699

2 months ago

0.75.0-nightly-20240324-4c8e253d8

2 months ago

0.75.0-nightly-20240322-b13e9f8f7

2 months ago

0.75.0-nightly-20240321-7d180d712

2 months ago

0.75.0-nightly-20240320-0267ca0a4

2 months ago

0.75.0-nightly-20240319-d97741af6

2 months ago

0.75.0-nightly-20240318-a87fb56ef

2 months ago

2 months ago

2 months ago

0.75.0-nightly-20240317-06dc448d8

2 months ago

0.75.0-nightly-20240316-06dc448d8

2 months ago

0.75.0-nightly-20240315-e180f805e

2 months ago

0.75.0-nightly-20240315-f2f62cdf5

2 months ago

0.75.0-nightly-20240312-41b637194

2 months ago

0.75.0-nightly-20240311-3706bf077

2 months ago

2 months ago

0.75.0-nightly-20240310-e2157f063

2 months ago

0.75.0-nightly-20240309-e2157f063

2 months ago

0.75.0-nightly-20240308-208be5000

2 months ago

0.75.0-nightly-20240308-6c28c87c4

2 months ago

0.75.0-nightly-20240307-ff03b149e

2 months ago

0.75.0-nightly-20240306-c645646a2

2 months ago

0.75.0-nightly-20240305-9aeb9f2f9

2 months ago

0.75.0-nightly-20240304-ec928d7a6

2 months ago

2 months ago

0.75.0-nightly-20240303-7d4778104

2 months ago

0.75.0-nightly-20240302-7d4778104

2 months ago

0.75.0-nightly-20240229-21171222e

2 months ago

0.75.0-nightly-20240227-8317325fb

2 months ago

0.75.0-nightly-20240228-252ef19c8

2 months ago

0.75.0-nightly-20240226-fcabb2ad2

2 months ago

0.75.0-nightly-20240222-2dc39c26e

3 months ago

0.75.0-nightly-20240225-12f2c3cd2

3 months ago

0.75.0-nightly-20240223-c7bacf610

3 months ago

3 months ago

0.75.0-nightly-20240221-a1171f79f

3 months ago

0.74.0-nightly-20240220-e9351f0f8

3 months ago

3 months ago

0.74.0-nightly-20240218-475a15631

3 months ago

0.74.0-nightly-20240219-28da7f9f5

3 months ago

0.74.0-nightly-20240217-8ff05b5a1

3 months ago

0.74.0-nightly-20240216-da03d7b82

3 months ago

0.74.0-nightly-20240215-15700626c

3 months ago

0.74.0-nightly-20240214-b8ad91732

3 months ago

0.74.0-nightly-20240208-b796cda38

3 months ago

0.74.0-nightly-20240207-5e03813d1

3 months ago

0.74.0-nightly-20240206-bc3fe0d76

3 months ago

0.74.0-nightly-20240205-e4342f5b0

3 months ago

0.74.0-nightly-20240203-4473fe8f2

3 months ago

0.74.0-nightly-20240204-fafd00ab1

3 months ago

0.74.0-nightly-20240202-af8c82dac

3 months ago

0.74.0-nightly-20240201-107f2f997

3 months ago

0.74.0-nightly-20240201-aefca27c6

3 months ago

0.74.0-nightly-20240131-82e9a5e4f

3 months ago

0.74.0-nightly-20240130-2f818b464

3 months ago

0.74.0-nightly-20240129-39cb02f6f

3 months ago

0.74.0-nightly-20240128-cfc0ba04a

3 months ago

0.74.0-nightly-20240127-cfc0ba04a

3 months ago

0.74.0-nightly-20240126-751eae94d

4 months ago

0.74.0-nightly-20240124-ccff2bb8d

4 months ago

0.74.0-nightly-20240123-cbd818dad

4 months ago

0.74.0-nightly-20240122-4e92f87df

4 months ago

0.74.0-nightly-20240121-a58ec074b

4 months ago

0.74.0-nightly-20240120-a58ec074b

4 months ago

0.74.0-nightly-20240119-461edd248

4 months ago

0.74.0-nightly-20240118-f30f86717

4 months ago

0.74.0-nightly-20240117-67532e07c

4 months ago

0.74.0-nightly-20240115-0c7008f28

4 months ago

0.74.0-nightly-20240113-e859f6c77

4 months ago

0.74.0-nightly-20240114-f30acc6f5

4 months ago

0.74.0-nightly-20240112-1a6f97f94

4 months ago

0.74.0-nightly-20240111-371af3f1c

4 months ago

0.74.0-nightly-20240110-822bf52c2

4 months ago

0.74.0-nightly-20240109-f7f9250f6

4 months ago

0.74.0-nightly-20240108-05ca2c6d8

4 months ago

4 months ago

0.74.0-nightly-20240106-cabae397c

4 months ago

0.74.0-nightly-20240105-016bb24ea

4 months ago

0.74.0-nightly-20240104-9ba3bc99e

4 months ago

0.74.0-nightly-20240102-05ec058ac

4 months ago

0.74.0-nightly-20240103-0e533f308

4 months ago

0.74.0-nightly-20231228-b5e08e80d

4 months ago

0.74.0-nightly-20231229-b5e08e80d

4 months ago

0.74.0-nightly-20231230-95bed60a1

4 months ago

0.74.0-nightly-20231227-c75abefea

5 months ago

0.74.0-nightly-20231226-55e4543ee

5 months ago

0.74.0-nightly-20231224-192a88d52

5 months ago

0.74.0-nightly-20231225-192a88d52

5 months ago

0.74.0-nightly-20231222-192a88d52

5 months ago

0.74.0-nightly-20231223-192a88d52

5 months ago

0.74.0-nightly-20231221-72b876a5a

5 months ago

0.74.0-nightly-20231220-dae4a11e9

5 months ago

0.74.0-nightly-20231218-27f38f6f0

5 months ago

0.74.0-nightly-20231217-2441fa284

5 months ago

0.74.0-nightly-20231216-479b4bb1b

5 months ago

0.74.0-nightly-20231215-d45a01d6d

5 months ago

0.74.0-nightly-20231214-b0982971c

5 months ago

5 months ago

0.74.0-nightly-20231213-746ad378c

5 months ago

0.74.0-nightly-20231211-ca9b6b503

5 months ago

0.74.0-nightly-20231212-1c77919fc

5 months ago

0.74.0-nightly-20231210-a9dd43c5c

5 months ago

0.74.0-nightly-20231208-82652f89c

5 months ago

0.74.0-nightly-20231207-80812658e

5 months ago

0.74.0-nightly-20231206-eb661df2a

5 months ago

0.74.0-nightly-20231205-ff7768038

5 months ago

0.74.0-nightly-20231204-e9b80971c

5 months ago

0.74.0-nightly-20231203-385473522

5 months ago

0.74.0-nightly-20231202-385473522

5 months ago

0.74.0-nightly-20231201-c30f2b620

5 months ago

0.74.0-nightly-20231130-7e5f15b88

5 months ago

0.74.0-nightly-20231129-c8db60c7a

5 months ago

0.74.0-nightly-20231128-528f97152

5 months ago

0.74.0-nightly-20231127-86c5abac2

6 months ago

0.74.0-nightly-20231126-b50a7093b

6 months ago

0.74.0-nightly-20231125-caae38891

6 months ago

0.74.0-nightly-20231124-c464b215e

6 months ago

0.74.0-nightly-20231123-342041e9e

6 months ago

0.74.0-nightly-20231122-d4399c5f1

6 months ago

0.74.0-nightly-20231121-a6964b362

6 months ago

0.74.0-nightly-20231119-9b1f8a81e

6 months ago

0.74.0-nightly-20231118-917fd25cb

6 months ago

0.74.0-nightly-20231117-ba43dd251

6 months ago

6 months ago

0.74.0-nightly-20231116-fa89dd68b

6 months ago

0.74.0-nightly-20231115-88233cf54

6 months ago

0.74.0-nightly-20231114-255fef526

6 months ago

0.74.0-nightly-20231113-6962b5fdd

6 months ago

0.74.0-nightly-20231112-1891d9e64

6 months ago

0.74.0-nightly-20231111-1891d9e64

6 months ago

0.74.0-nightly-20231110-9b33e752c

6 months ago

0.74.0-nightly-20231109-9320174df

6 months ago

0.74.0-nightly-20231108-05d92bf2a

6 months ago

0.74.0-nightly-20231107-bc68794c6

6 months ago

0.74.0-nightly-20231106-1e21e3469

6 months ago

0.74.0-nightly-20231105-d077239ff

6 months ago

0.74.0-nightly-20231104-d077239ff

6 months ago

0.74.0-nightly-20231103-9b613855e

6 months ago

0.74.0-nightly-20231102-9240d5160

6 months ago

0.74.0-nightly-20231101-0f8a83eb4

6 months ago

0.74.0-nightly-20231031-572dd76ba

6 months ago

0.74.0-nightly-20231030-a4a8695ce

6 months ago

0.74.0-nightly-20231029-118e651bc

6 months ago

0.74.0-nightly-20231028-118e651bc

7 months ago

0.74.0-nightly-20231027-118e651bc

7 months ago

0.74.0-nightly-20231026-6b3289bc7

7 months ago

0.74.0-nightly-20231025-97647d118

7 months ago

0.74.0-nightly-20231024-b5dae017f

7 months ago

0.74.0-nightly-20231023-1923a4e2f

7 months ago

0.74.0-nightly-20231022-02397763f

7 months ago

0.74.0-nightly-20231021-02397763f

7 months ago

0.74.0-nightly-20231020-a1299938a

7 months ago

0.74.0-nightly-20231019-30b9b01e6

7 months ago

7 months ago

0.74.0-nightly-20231018-191c3deae

7 months ago

0.74.0-nightly-20231017-81ae532dd

7 months ago

0.74.0-nightly-20231016-44660019e

7 months ago

0.74.0-nightly-20231015-a2f11895c

7 months ago

0.74.0-nightly-20231014-a2f11895c

7 months ago

0.74.0-nightly-20231013-a030224d1

7 months ago

0.74.0-nightly-20231012-02957718d

7 months ago

0.74.0-nightly-20231012-02e53ebc4

7 months ago

0.74.0-nightly-20231012-8f7ffc4d5

7 months ago

0.74.0-nightly-20231011-fb194788c

7 months ago

7 months ago

0.74.0-nightly-20231010-7b7f12896

7 months ago

0.74.0-nightly-20231009-ec1de6194

7 months ago

0.74.0-nightly-20231008-60f5a80c1

7 months ago

0.74.0-nightly-20231007-60f5a80c1

7 months ago

0.74.0-nightly-20231006-60f5a80c1

7 months ago

0.74.0-nightly-20231005-1b9b13a7b

7 months ago

0.74.0-nightly-20231004-2000acc6c

7 months ago

0.74.0-nightly-20231003-5dedf277c

7 months ago

0.73.0-nightly-20231002-0371014a3

7 months ago

7 months ago

0.73.0-nightly-20231001-d95433f82

7 months ago

0.73.0-nightly-20230930-df492cc4e

7 months ago

0.73.0-nightly-20230929-6635474e3

7 months ago

0.73.0-nightly-20230928-8e36cc029

8 months ago

0.73.0-nightly-20230926-aa1dffbb4

8 months ago

8 months ago

0.73.0-nightly-20230926-27b631e5b

8 months ago

0.73.0-nightly-20230925-2de964cfd

8 months ago

0.73.0-nightly-20230924-030663bb0

8 months ago

0.73.0-nightly-20230923-29f62a41b

8 months ago

0.73.0-nightly-20230922-2fb4547aa

8 months ago

0.73.0-nightly-20230922-353b31c7d

8 months ago

0.73.0-nightly-20230922-52104c6ee

8 months ago

9 months ago