A custom networking layer for Postman.
Download the package:
npm i @postman/wormholeUse the package in your script:
const wormhole = require('@postman/wormhole');
(async () => {
try {
const response = await wormhole.request('https://postman-echo.com/get');
console.log(response);
} catch(err) {
console.error(err);
}
})();
// Output:
// {
// body: '{\n' +
// ' "args": {},\n' +
// ' "headers": {\n' +
// ' "x-forwarded-proto": "https",\n' +
// ' "x-forwarded-port": "443",\n' +
// ' "host": "postman-echo.com",\n' +
// ' "x-amzn-trace-id": "Root=1-6438234d-250ea6600158d4327b34959d",\n' +
// ' "accept": "*/*"\n' +
// ' },\n' +
// ' "url": "https://postman-echo.com/get"\n' +
// '}',
// code: 200,
// headers: {
// 'content-length': '261',
// 'content-type': 'application/json; charset=utf-8',
// date: 'Thu, 13 Apr 2023 15:44:13 GMT',
// etag: 'W/"105-OKIvRBN7dFw60TIXeTUkRZ806Jg"',
// 'set-cookie': 'sails.sid=s%3AKUokDmAh5iy3387VhsanT2xmvi5OBSxe.0brItKRppniSDZ5E7tsP4KQAKKbO4iDUE5uxKk1pUZw; Path=/; HttpOnly'
// }
// }Check out the JS API documentation.
Compile with the wormhole shared library present in relocatable_libwormhole_<arch>
(arch is x86_64 or arm64):
clang++ \
-std=c++17 \
<entry/point.cc> \
-I<path/to/relocatable_libwormhole_<arch>/include> \
-L<path/to/relocatable_libwormhole_<arch>/lib> \
-lwormhole \
-rpath @executable_path/<relative/path/to/relocatable_libwormhole_<arch>>Use the library in your program:
#include <request.h>
...
wormhole::Response res =
wormhole::request("https://quic.aiortc.org/",
wormhole::RequestOptionsBuilder()
.set_http_version(wormhole::HTTPVersion::v3_ONLY)
.build());
std::cout << res.body << std::endl;
...
// Output:
// ...
// <p>
// Congratulations, you loaded this page using HTTP/3!
// </p>
// ...Check out the C++ API documentation.
The wormhole project uses libcurl in the networking layer. However, it doesn't require libcurl to be installed on the end user's system for use because wormhole ships with a standalone, relocatable build of libcurl.
Requests can be sent to QUIC endpoints like https://quic.aiortc.org.
const wormhole = require('@postman/wormhole');
(async () => {
const response = await wormhole.request('https://quic.aiortc.org', {
httpVersion: '3-only'
});
console.log(response);
})();
// Output:
// ...
// <p>
// Congratulations, you loaded this page using HTTP/3!
// </p>
// ...The HTTP/2 protocol is supported. To verify, set up the HTTP/2-only server documented in https://nodejs.org/api/http2.html#server-side-example and run:
const wormhole = require('@postman/wormhole');
(async () => {
const response = await wormhole.request('https://localhost:8443', {
ca: 'localhost-cert.pem'
});
console.log(response);
})();
// Output:
// {
// body: '<h1>Hello World</h1>',
// code: 200,
// headers: {
// 'content-type': 'text/html; charset=utf-8',
// date: 'Thu, 13 Apr 2023 15:45:40 GMT'
// }
// }The wormhole project uses the quictls fork of OpenSSL - https://github.com/quictls/openssl for SSL.
x86_64- macOS 10.15 and abovearm64- macOS 11 and above