This is a collection of guides on how to run and update undici
, and how to run different parts of the project.
The HTTP parser used by undici
is a WebAssembly build of llhttp
.
While the project itself provides a way to compile targeting WebAssembly, at the moment we embed the sources
directly and compile the module in undici
.
The deps/llhttp/include
folder contains the C header files, while the deps/llhttp/src
folder contains
the C source files needed to compile the module.
The lib/llhttp
folder contains the .js
transpiled assets required to implement a parser.
The following are the steps required to perform an update.
Clone the llhttp project
git clone git@github.com:nodejs/llhttp.git
cd llhttp
git checkout <tag>
npm i
This requires docker installed on your machine.
npm run build-wasm
cp build/wasm/*.js <your-path-to-undici>/lib/llhttp/
cp build/wasm/*.js.map <your-path-to-undici>/lib/llhttp/
cp build/wasm/*.d.ts <your-path-to-undici>/lib/llhttp/
cp src/native/api.c src/native/http.c build/c/llhttp.c <your-path-to-undici>/deps/llhttp/src/
cp src/native/api.h build/llhttp.h <your-path-to-undici>/deps/llhttp/include/
This requires docker installed on your machine.
cd <your-path-to-undici>
npm run build:wasm
Create a commit which includes all of the updated files in lib/llhttp.
undici
runs a subset of the web-platform-tests
.
- Node core utils setup with credentials.
To update every test, run the following commands. Typically you would only need to update the tests in a specific directory.
git node wpt resources
git node wpt interfaces
git node wpt common
git node wpt fetch
git node wpt xhr
git node wpt websockets
git node wpt mimesniff
git node wpt storage
git node wpt service-workers
git node wpt eventsource
Run the tests to ensure that any new failures are marked as such.
You can mark tests as failing in their corresponding status file.
npm run test:wpt
npm run lint
npm run test
npm run coverage
Release is automatic on commit to main which bumps the package.json version field. Use the "Create release PR" github action to generate a release PR.
If you are packaging undici
for a distro, this might help if you would like to use
an unbundled version instead of bundling one in libnode.so
.
To enable this, pass EXTERNAL_PATH=/path/to/global/node_modules/undici
to build/wasm.js
.
Pass this path with loader.js
appended to --shared-builtin-undici/undici-path
in Node.js's configure.py
.
If building on a non-Alpine Linux distribution, you may need to also set the WASM_CC
, WASM_CFLAGS
, WASM_LDFLAGS
and WASM_LDLIBS
environment variables before running build/wasm.js
.
Similarly, you can set the WASM_OPT
environment variable to utilize your own wasm-opt
optimizer.
cd benchmarks && npm i && npm run bench
The benchmarks will be available at http://localhost:3042
.
cd docs && npm i && npm run serve
The documentation will be available at http://localhost:3000
.
By making a contribution to this project, I certify that:
-
(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
-
(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
-
(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
-
(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.
The Node.js Moderation Policy applies to this project.