GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — lib: add WebSocket client · nodejs/node@a01050d

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
  • .eslintrc.js
  • doc
    • api
      • cli.md
      • globals.md
    • node.1
  • lib/internal/process
    • pre_execution.js
  • src
    • node_options.cc
    • node_options.h
  • test
    • common
      • globals.js
      • index.js
    • parallel
      • test-websocket.js
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎.eslintrc.js‎

Copy file name to clipboardExpand all lines: .eslintrc.js
+1Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -360,5 +360,6 @@ module.exports = {
360360
WritableStream: 'readable',
361361
WritableStreamDefaultWriter: 'readable',
362362
WritableStreamDefaultController: 'readable',
363+
WebSocket: 'readable',
363364
},
364365
};
Collapse file

‎doc/api/cli.md‎

Copy file name to clipboardExpand all lines: doc/api/cli.md
+10Lines changed: 10 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -725,6 +725,14 @@ added: v12.3.0
725725

726726
Enable experimental WebAssembly module support.
727727

728+
### `--experimental-websocket`
729+
730+
<!-- YAML
731+
added: REPLACEME
732+
-->
733+
734+
Enable experimental [`WebSocket`][] support.
735+
728736
### `--force-context-aware`
729737

730738
<!-- YAML
@@ -2220,6 +2228,7 @@ Node.js options that are allowed are:
22202228
* `--experimental-vm-modules`
22212229
* `--experimental-wasi-unstable-preview1`
22222230
* `--experimental-wasm-modules`
2231+
* `--experimental-websocket`
22232232
* `--force-context-aware`
22242233
* `--force-fips`
22252234
* `--force-node-api-uncaught-exceptions-policy`
@@ -2687,6 +2696,7 @@ done
26872696
[`NODE_OPTIONS`]: #node_optionsoptions
26882697
[`NO_COLOR`]: https://no-color.org
26892698
[`SlowBuffer`]: buffer.md#class-slowbuffer
2699+
[`WebSocket`]: https://developer.mozilla.org/en-US/docs/Web/API/WebSocket
26902700
[`YoungGenerationSizeFromSemiSpaceSize`]: https://chromium.googlesource.com/v8/v8.git/+/refs/tags/10.3.129/src/heap/heap.cc#328
26912701
[`dns.lookup()`]: dns.md#dnslookuphostname-options-callback
26922702
[`dns.setDefaultResultOrder()`]: dns.md#dnssetdefaultresultorderorder
Collapse file

‎doc/api/globals.md‎

Copy file name to clipboardExpand all lines: doc/api/globals.md
+13Lines changed: 13 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -966,6 +966,17 @@ The object that acts as the namespace for all W3C
966966
[WebAssembly][webassembly-org] related functionality. See the
967967
[Mozilla Developer Network][webassembly-mdn] for usage and compatibility.
968968

969+
## `WebSocket`
970+
971+
<!-- YAML
972+
added: REPLACEME
973+
-->
974+
975+
> Stability: 1 - Experimental.
976+
977+
A browser-compatible implementation of [`WebSocket`][]. Enable this API
978+
with the [`--experimental-websocket`][] CLI flag.
979+
969980
## Class: `WritableStream`
970981

971982
<!-- YAML
@@ -999,6 +1010,7 @@ A browser-compatible implementation of [`WritableStreamDefaultWriter`][].
9991010
[CommonJS module]: modules.md
10001011
[ECMAScript module]: esm.md
10011012
[Web Crypto API]: webcrypto.md
1013+
[`--experimental-websocket`]: cli.md#--experimental-websocket
10021014
[`--no-experimental-fetch`]: cli.md#--no-experimental-fetch
10031015
[`--no-experimental-global-customevent`]: cli.md#--no-experimental-global-customevent
10041016
[`--no-experimental-global-webcrypto`]: cli.md#--no-experimental-global-webcrypto
@@ -1033,6 +1045,7 @@ A browser-compatible implementation of [`WritableStreamDefaultWriter`][].
10331045
[`TransformStream`]: webstreams.md#class-transformstream
10341046
[`URLSearchParams`]: url.md#class-urlsearchparams
10351047
[`URL`]: url.md#class-url
1048+
[`WebSocket`]: https://developer.mozilla.org/en-US/docs/Web/API/WebSocket
10361049
[`WritableStreamDefaultController`]: webstreams.md#class-writablestreamdefaultcontroller
10371050
[`WritableStreamDefaultWriter`]: webstreams.md#class-writablestreamdefaultwriter
10381051
[`WritableStream`]: webstreams.md#class-writablestream
Collapse file

‎doc/node.1‎

Copy file name to clipboardExpand all lines: doc/node.1
+3Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,9 @@ Use this flag to enable ShadowRealm support.
178178
.It Fl -experimental-test-coverage
179179
Enable code coverage in the test runner.
180180
.
181+
.It Fl -experimental-websocket
182+
Enable experimental support for the WebSocket API.
183+
.
181184
.It Fl -no-experimental-fetch
182185
Disable experimental support for the Fetch API.
183186
.
Collapse file

‎lib/internal/process/pre_execution.js‎

Copy file name to clipboardExpand all lines: lib/internal/process/pre_execution.js
+28-20Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ function prepareExecution(options) {
7878
setupTraceCategoryState();
7979
setupInspectorHooks();
8080
setupWarningHandler();
81-
setupFetch();
81+
setupUndici();
8282
setupWebCrypto();
8383
setupCustomEvent();
8484
setupCodeCoverage();
@@ -262,9 +262,9 @@ function setupWarningHandler() {
262262
}
263263

264264
// https://fetch.spec.whatwg.org/
265-
function setupFetch() {
266-
if (getEmbedderOptions().noBrowserGlobals ||
267-
getOptionValue('--no-experimental-fetch')) {
265+
// https://websockets.spec.whatwg.org/
266+
function setupUndici() {
267+
if (getEmbedderOptions().noBrowserGlobals) {
268268
return;
269269
}
270270

@@ -278,12 +278,6 @@ function setupFetch() {
278278
return undici;
279279
}
280280

281-
async function fetch(input, init = undefined) {
282-
return lazyUndici().fetch(input, init);
283-
}
284-
285-
defineOperation(globalThis, 'fetch', fetch);
286-
287281
function lazyInterface(name) {
288282
return {
289283
configurable: true,
@@ -297,17 +291,31 @@ function setupFetch() {
297291
};
298292
}
299293

300-
ObjectDefineProperties(globalThis, {
301-
FormData: lazyInterface('FormData'),
302-
Headers: lazyInterface('Headers'),
303-
Request: lazyInterface('Request'),
304-
Response: lazyInterface('Response'),
305-
});
294+
if (!getOptionValue('--no-experimental-fetch')) {
295+
async function fetch(input, init = undefined) {
296+
return lazyUndici().fetch(input, init);
297+
}
306298

307-
// The WebAssembly Web API: https://webassembly.github.io/spec/web-api
308-
internalBinding('wasm_web_api').setImplementation((streamState, source) => {
309-
require('internal/wasm_web_api').wasmStreamingCallback(streamState, source);
310-
});
299+
defineOperation(globalThis, 'fetch', fetch);
300+
301+
ObjectDefineProperties(globalThis, {
302+
FormData: lazyInterface('FormData'),
303+
Headers: lazyInterface('Headers'),
304+
Request: lazyInterface('Request'),
305+
Response: lazyInterface('Response'),
306+
});
307+
308+
// The WebAssembly Web API: https://webassembly.github.io/spec/web-api
309+
internalBinding('wasm_web_api').setImplementation((streamState, source) => {
310+
require('internal/wasm_web_api').wasmStreamingCallback(streamState, source);
311+
});
312+
}
313+
314+
if (getOptionValue('--experimental-websocket')) {
315+
ObjectDefineProperties(globalThis, {
316+
WebSocket: lazyInterface('WebSocket'),
317+
});
318+
}
311319
}
312320

313321
// TODO(aduh95): move this to internal/bootstrap/web/* when the CLI flag is
Collapse file

‎src/node_options.cc‎

Copy file name to clipboardExpand all lines: src/node_options.cc
+5Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -370,6 +370,11 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
370370
&EnvironmentOptions::experimental_fetch,
371371
kAllowedInEnvvar,
372372
true);
373+
AddOption("--experimental-websocket",
374+
"experimental WebSocket API",
375+
&EnvironmentOptions::experimental_websocket,
376+
kAllowedInEnvvar,
377+
true);
373378
AddOption("--experimental-global-customevent",
374379
"expose experimental CustomEvent on the global scope",
375380
&EnvironmentOptions::experimental_global_customevent,
Collapse file

‎src/node_options.h‎

Copy file name to clipboardExpand all lines: src/node_options.h
+1Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,7 @@ class EnvironmentOptions : public Options {
111111
std::string dns_result_order;
112112
bool enable_source_maps = false;
113113
bool experimental_fetch = true;
114+
bool experimental_websocket = false;
114115
bool experimental_global_customevent = true;
115116
bool experimental_global_web_crypto = true;
116117
bool experimental_https_modules = false;
Collapse file

‎test/common/globals.js‎

Copy file name to clipboardExpand all lines: test/common/globals.js
+1Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,7 @@ const webIdlExposedWindow = new Set([
123123
'Headers',
124124
'Request',
125125
'Response',
126+
'WebSocket',
126127
]);
127128

128129
const nodeGlobals = new Set([
Collapse file

‎test/common/index.js‎

Copy file name to clipboardExpand all lines: test/common/index.js
+3Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -362,6 +362,9 @@ if (global.ReadableStream) {
362362
global.DecompressionStream,
363363
);
364364
}
365+
if (global.WebSocket) {
366+
knownGlobals.push(WebSocket);
367+
}
365368

366369
function allowGlobals(...allowlist) {
367370
knownGlobals = knownGlobals.concat(allowlist);
Collapse file

‎test/parallel/test-websocket.js‎

Copy file name to clipboard
+7Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
// Flags: --experimental-websocket
2+
'use strict';
3+
4+
require('../common');
5+
const assert = require('assert');
6+
7+
assert.strictEqual(typeof WebSocket, 'function');

0 commit comments

Comments
0 (0)
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.