cdk-common 2.0.1351 → 2.0.1353
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.jsii +38 -2
- package/API.md +36 -0
- package/lib/main.js +1 -1
- package/lib/managed-policies.d.ts +7 -1
- package/lib/managed-policies.js +7 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/README.md +1 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/assert/strict.d.ts +5 -11
- package/node_modules/@types/concat-stream/node_modules/@types/node/assert.d.ts +9 -169
- package/node_modules/@types/concat-stream/node_modules/@types/node/async_hooks.d.ts +8 -8
- package/node_modules/@types/concat-stream/node_modules/@types/node/buffer.buffer.d.ts +1 -7
- package/node_modules/@types/concat-stream/node_modules/@types/node/buffer.d.ts +44 -168
- package/node_modules/@types/concat-stream/node_modules/@types/node/child_process.d.ts +16 -64
- package/node_modules/@types/concat-stream/node_modules/@types/node/cluster.d.ts +240 -332
- package/node_modules/@types/concat-stream/node_modules/@types/node/console.d.ts +49 -351
- package/node_modules/@types/concat-stream/node_modules/@types/node/constants.d.ts +3 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/crypto.d.ts +279 -1631
- package/node_modules/@types/concat-stream/node_modules/@types/node/dgram.d.ts +15 -51
- package/node_modules/@types/concat-stream/node_modules/@types/node/diagnostics_channel.d.ts +4 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/dns/promises.d.ts +3 -3
- package/node_modules/@types/concat-stream/node_modules/@types/node/dns.d.ts +131 -132
- package/node_modules/@types/concat-stream/node_modules/@types/node/domain.d.ts +13 -17
- package/node_modules/@types/concat-stream/node_modules/@types/node/events.d.ts +869 -791
- package/node_modules/@types/concat-stream/node_modules/@types/node/fs/promises.d.ts +7 -8
- package/node_modules/@types/concat-stream/node_modules/@types/node/fs.d.ts +417 -455
- package/node_modules/@types/concat-stream/node_modules/@types/node/globals.d.ts +6 -26
- package/node_modules/@types/concat-stream/node_modules/@types/node/globals.typedarray.d.ts +60 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/http.d.ts +263 -254
- package/node_modules/@types/concat-stream/node_modules/@types/node/http2.d.ts +528 -804
- package/node_modules/@types/concat-stream/node_modules/@types/node/https.d.ts +59 -239
- package/node_modules/@types/concat-stream/node_modules/@types/node/index.d.ts +15 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/inspector/promises.d.ts +41 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/inspector.d.ts +6 -59
- package/node_modules/@types/concat-stream/node_modules/@types/node/inspector.generated.d.ts +3 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/module.d.ts +47 -122
- package/node_modules/@types/concat-stream/node_modules/@types/node/net.d.ts +63 -184
- package/node_modules/@types/concat-stream/node_modules/@types/node/os.d.ts +6 -6
- package/node_modules/@types/concat-stream/node_modules/@types/node/package.json +2 -2
- package/node_modules/@types/concat-stream/node_modules/@types/node/path/posix.d.ts +8 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/path/win32.d.ts +8 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/path.d.ts +120 -133
- package/node_modules/@types/concat-stream/node_modules/@types/node/perf_hooks.d.ts +282 -643
- package/node_modules/@types/concat-stream/node_modules/@types/node/process.d.ts +156 -128
- package/node_modules/@types/concat-stream/node_modules/@types/node/punycode.d.ts +5 -5
- package/node_modules/@types/concat-stream/node_modules/@types/node/querystring.d.ts +4 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/quic.d.ts +910 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/readline/promises.d.ts +3 -3
- package/node_modules/@types/concat-stream/node_modules/@types/node/readline.d.ts +67 -120
- package/node_modules/@types/concat-stream/node_modules/@types/node/repl.d.ts +75 -98
- package/node_modules/@types/concat-stream/node_modules/@types/node/sea.d.ts +1 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/sqlite.d.ts +2 -2
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream/consumers.d.ts +10 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream/promises.d.ts +136 -15
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream/web.d.ts +176 -453
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream.d.ts +555 -478
- package/node_modules/@types/concat-stream/node_modules/@types/node/string_decoder.d.ts +4 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/test/reporters.d.ts +96 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/test.d.ts +80 -180
- package/node_modules/@types/concat-stream/node_modules/@types/node/timers/promises.d.ts +4 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/timers.d.ts +4 -130
- package/node_modules/@types/concat-stream/node_modules/@types/node/tls.d.ts +102 -177
- package/node_modules/@types/concat-stream/node_modules/@types/node/trace_events.d.ts +9 -9
- package/node_modules/@types/concat-stream/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +1 -7
- package/node_modules/@types/concat-stream/node_modules/@types/node/ts5.6/index.d.ts +15 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/ts5.7/index.d.ts +15 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/tty.d.ts +58 -16
- package/node_modules/@types/concat-stream/node_modules/@types/node/url.d.ts +54 -592
- package/node_modules/@types/concat-stream/node_modules/@types/node/util/types.d.ts +558 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/util.d.ts +120 -792
- package/node_modules/@types/concat-stream/node_modules/@types/node/v8.d.ts +32 -5
- package/node_modules/@types/concat-stream/node_modules/@types/node/vm.d.ts +13 -13
- package/node_modules/@types/concat-stream/node_modules/@types/node/wasi.d.ts +4 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/abortcontroller.d.ts +27 -2
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/blob.d.ts +23 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/console.d.ts +9 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/crypto.d.ts +7 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/encoding.d.ts +11 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/events.d.ts +9 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/fetch.d.ts +4 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/importmeta.d.ts +13 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/messaging.d.ts +23 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/performance.d.ts +45 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/streams.d.ts +93 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/timers.d.ts +44 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/web-globals/url.d.ts +24 -0
- package/node_modules/@types/concat-stream/node_modules/@types/node/worker_threads.d.ts +176 -358
- package/node_modules/@types/concat-stream/node_modules/@types/node/zlib.d.ts +8 -71
- package/node_modules/@types/form-data/node_modules/@types/node/README.md +1 -1
- package/node_modules/@types/form-data/node_modules/@types/node/assert/strict.d.ts +5 -11
- package/node_modules/@types/form-data/node_modules/@types/node/assert.d.ts +9 -169
- package/node_modules/@types/form-data/node_modules/@types/node/async_hooks.d.ts +8 -8
- package/node_modules/@types/form-data/node_modules/@types/node/buffer.buffer.d.ts +1 -7
- package/node_modules/@types/form-data/node_modules/@types/node/buffer.d.ts +44 -168
- package/node_modules/@types/form-data/node_modules/@types/node/child_process.d.ts +16 -64
- package/node_modules/@types/form-data/node_modules/@types/node/cluster.d.ts +240 -332
- package/node_modules/@types/form-data/node_modules/@types/node/console.d.ts +49 -351
- package/node_modules/@types/form-data/node_modules/@types/node/constants.d.ts +3 -4
- package/node_modules/@types/form-data/node_modules/@types/node/crypto.d.ts +279 -1631
- package/node_modules/@types/form-data/node_modules/@types/node/dgram.d.ts +15 -51
- package/node_modules/@types/form-data/node_modules/@types/node/diagnostics_channel.d.ts +4 -4
- package/node_modules/@types/form-data/node_modules/@types/node/dns/promises.d.ts +3 -3
- package/node_modules/@types/form-data/node_modules/@types/node/dns.d.ts +131 -132
- package/node_modules/@types/form-data/node_modules/@types/node/domain.d.ts +13 -17
- package/node_modules/@types/form-data/node_modules/@types/node/events.d.ts +869 -791
- package/node_modules/@types/form-data/node_modules/@types/node/fs/promises.d.ts +7 -8
- package/node_modules/@types/form-data/node_modules/@types/node/fs.d.ts +417 -455
- package/node_modules/@types/form-data/node_modules/@types/node/globals.d.ts +6 -26
- package/node_modules/@types/form-data/node_modules/@types/node/globals.typedarray.d.ts +60 -0
- package/node_modules/@types/form-data/node_modules/@types/node/http.d.ts +263 -254
- package/node_modules/@types/form-data/node_modules/@types/node/http2.d.ts +528 -804
- package/node_modules/@types/form-data/node_modules/@types/node/https.d.ts +59 -239
- package/node_modules/@types/form-data/node_modules/@types/node/index.d.ts +15 -1
- package/node_modules/@types/form-data/node_modules/@types/node/inspector/promises.d.ts +41 -0
- package/node_modules/@types/form-data/node_modules/@types/node/inspector.d.ts +6 -59
- package/node_modules/@types/form-data/node_modules/@types/node/inspector.generated.d.ts +3 -10
- package/node_modules/@types/form-data/node_modules/@types/node/module.d.ts +47 -122
- package/node_modules/@types/form-data/node_modules/@types/node/net.d.ts +63 -184
- package/node_modules/@types/form-data/node_modules/@types/node/os.d.ts +6 -6
- package/node_modules/@types/form-data/node_modules/@types/node/package.json +2 -2
- package/node_modules/@types/form-data/node_modules/@types/node/path/posix.d.ts +8 -0
- package/node_modules/@types/form-data/node_modules/@types/node/path/win32.d.ts +8 -0
- package/node_modules/@types/form-data/node_modules/@types/node/path.d.ts +120 -133
- package/node_modules/@types/form-data/node_modules/@types/node/perf_hooks.d.ts +282 -643
- package/node_modules/@types/form-data/node_modules/@types/node/process.d.ts +156 -128
- package/node_modules/@types/form-data/node_modules/@types/node/punycode.d.ts +5 -5
- package/node_modules/@types/form-data/node_modules/@types/node/querystring.d.ts +4 -4
- package/node_modules/@types/form-data/node_modules/@types/node/quic.d.ts +910 -0
- package/node_modules/@types/form-data/node_modules/@types/node/readline/promises.d.ts +3 -3
- package/node_modules/@types/form-data/node_modules/@types/node/readline.d.ts +67 -120
- package/node_modules/@types/form-data/node_modules/@types/node/repl.d.ts +75 -98
- package/node_modules/@types/form-data/node_modules/@types/node/sea.d.ts +1 -1
- package/node_modules/@types/form-data/node_modules/@types/node/sqlite.d.ts +2 -2
- package/node_modules/@types/form-data/node_modules/@types/node/stream/consumers.d.ts +10 -10
- package/node_modules/@types/form-data/node_modules/@types/node/stream/promises.d.ts +136 -15
- package/node_modules/@types/form-data/node_modules/@types/node/stream/web.d.ts +176 -453
- package/node_modules/@types/form-data/node_modules/@types/node/stream.d.ts +555 -478
- package/node_modules/@types/form-data/node_modules/@types/node/string_decoder.d.ts +4 -4
- package/node_modules/@types/form-data/node_modules/@types/node/test/reporters.d.ts +96 -0
- package/node_modules/@types/form-data/node_modules/@types/node/test.d.ts +80 -180
- package/node_modules/@types/form-data/node_modules/@types/node/timers/promises.d.ts +4 -4
- package/node_modules/@types/form-data/node_modules/@types/node/timers.d.ts +4 -130
- package/node_modules/@types/form-data/node_modules/@types/node/tls.d.ts +102 -177
- package/node_modules/@types/form-data/node_modules/@types/node/trace_events.d.ts +9 -9
- package/node_modules/@types/form-data/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +1 -7
- package/node_modules/@types/form-data/node_modules/@types/node/ts5.6/index.d.ts +15 -1
- package/node_modules/@types/form-data/node_modules/@types/node/ts5.7/index.d.ts +15 -1
- package/node_modules/@types/form-data/node_modules/@types/node/tty.d.ts +58 -16
- package/node_modules/@types/form-data/node_modules/@types/node/url.d.ts +54 -592
- package/node_modules/@types/form-data/node_modules/@types/node/util/types.d.ts +558 -0
- package/node_modules/@types/form-data/node_modules/@types/node/util.d.ts +120 -792
- package/node_modules/@types/form-data/node_modules/@types/node/v8.d.ts +32 -5
- package/node_modules/@types/form-data/node_modules/@types/node/vm.d.ts +13 -13
- package/node_modules/@types/form-data/node_modules/@types/node/wasi.d.ts +4 -4
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/abortcontroller.d.ts +27 -2
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/blob.d.ts +23 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/console.d.ts +9 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/crypto.d.ts +7 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/encoding.d.ts +11 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/events.d.ts +9 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/fetch.d.ts +4 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/importmeta.d.ts +13 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/messaging.d.ts +23 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/performance.d.ts +45 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/streams.d.ts +93 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/timers.d.ts +44 -0
- package/node_modules/@types/form-data/node_modules/@types/node/web-globals/url.d.ts +24 -0
- package/node_modules/@types/form-data/node_modules/@types/node/worker_threads.d.ts +176 -358
- package/node_modules/@types/form-data/node_modules/@types/node/zlib.d.ts +8 -71
- package/package.json +4 -4
|
@@ -5,10 +5,10 @@
|
|
|
5
5
|
* ```js
|
|
6
6
|
* import url from 'node:url';
|
|
7
7
|
* ```
|
|
8
|
-
* @see [source](https://github.com/nodejs/node/blob/
|
|
8
|
+
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/url.js)
|
|
9
9
|
*/
|
|
10
|
-
declare module "url" {
|
|
11
|
-
import { Blob
|
|
10
|
+
declare module "node:url" {
|
|
11
|
+
import { Blob, NonSharedBuffer } from "node:buffer";
|
|
12
12
|
import { ClientRequestArgs } from "node:http";
|
|
13
13
|
import { ParsedUrlQuery, ParsedUrlQueryInput } from "node:querystring";
|
|
14
14
|
// Input to `url.format`
|
|
@@ -74,7 +74,7 @@ declare module "url" {
|
|
|
74
74
|
* strings. It is prone to security issues such as [host name spoofing](https://hackerone.com/reports/678487)
|
|
75
75
|
* and incorrect handling of usernames and passwords. Do not use with untrusted
|
|
76
76
|
* input. CVEs are not issued for `url.parse()` vulnerabilities. Use the
|
|
77
|
-
* [WHATWG URL](https://nodejs.org/docs/latest-
|
|
77
|
+
* [WHATWG URL](https://nodejs.org/docs/latest-v25.x/api/url.html#the-whatwg-url-api) API instead, for example:
|
|
78
78
|
*
|
|
79
79
|
* ```js
|
|
80
80
|
* function getURL(req) {
|
|
@@ -97,7 +97,7 @@ declare module "url" {
|
|
|
97
97
|
* @deprecated Use the WHATWG URL API instead.
|
|
98
98
|
* @param urlString The URL string to parse.
|
|
99
99
|
* @param parseQueryString If `true`, the `query` property will always
|
|
100
|
-
* be set to an object returned by the [`querystring`](https://nodejs.org/docs/latest-
|
|
100
|
+
* be set to an object returned by the [`querystring`](https://nodejs.org/docs/latest-v25.x/api/querystring.html) module's `parse()`
|
|
101
101
|
* method. If `false`, the `query` property on the returned URL object will be an
|
|
102
102
|
* unparsed, undecoded string. **Default:** `false`.
|
|
103
103
|
* @param slashesDenoteHost If `true`, the first token after the literal
|
|
@@ -418,381 +418,8 @@ declare module "url" {
|
|
|
418
418
|
*/
|
|
419
419
|
unicode?: boolean | undefined;
|
|
420
420
|
}
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
* Standard. [Examples of parsed URLs](https://url.spec.whatwg.org/#example-url-parsing) may be found in the Standard itself.
|
|
424
|
-
* The `URL` class is also available on the global object.
|
|
425
|
-
*
|
|
426
|
-
* In accordance with browser conventions, all properties of `URL` objects
|
|
427
|
-
* are implemented as getters and setters on the class prototype, rather than as
|
|
428
|
-
* data properties on the object itself. Thus, unlike `legacy urlObject`s,
|
|
429
|
-
* using the `delete` keyword on any properties of `URL` objects (e.g. `delete myURL.protocol`, `delete myURL.pathname`, etc) has no effect but will still
|
|
430
|
-
* return `true`.
|
|
431
|
-
* @since v7.0.0, v6.13.0
|
|
432
|
-
*/
|
|
433
|
-
class URL {
|
|
434
|
-
/**
|
|
435
|
-
* Creates a `'blob:nodedata:...'` URL string that represents the given `Blob` object and can be used to retrieve the `Blob` later.
|
|
436
|
-
*
|
|
437
|
-
* ```js
|
|
438
|
-
* import {
|
|
439
|
-
* Blob,
|
|
440
|
-
* resolveObjectURL,
|
|
441
|
-
* } from 'node:buffer';
|
|
442
|
-
*
|
|
443
|
-
* const blob = new Blob(['hello']);
|
|
444
|
-
* const id = URL.createObjectURL(blob);
|
|
445
|
-
*
|
|
446
|
-
* // later...
|
|
447
|
-
*
|
|
448
|
-
* const otherBlob = resolveObjectURL(id);
|
|
449
|
-
* console.log(otherBlob.size);
|
|
450
|
-
* ```
|
|
451
|
-
*
|
|
452
|
-
* The data stored by the registered `Blob` will be retained in memory until `URL.revokeObjectURL()` is called to remove it.
|
|
453
|
-
*
|
|
454
|
-
* `Blob` objects are registered within the current thread. If using Worker
|
|
455
|
-
* Threads, `Blob` objects registered within one Worker will not be available
|
|
456
|
-
* to other workers or the main thread.
|
|
457
|
-
* @since v16.7.0
|
|
458
|
-
*/
|
|
459
|
-
static createObjectURL(blob: NodeBlob): string;
|
|
460
|
-
/**
|
|
461
|
-
* Removes the stored `Blob` identified by the given ID. Attempting to revoke a
|
|
462
|
-
* ID that isn't registered will silently fail.
|
|
463
|
-
* @since v16.7.0
|
|
464
|
-
* @param id A `'blob:nodedata:...` URL string returned by a prior call to `URL.createObjectURL()`.
|
|
465
|
-
*/
|
|
466
|
-
static revokeObjectURL(id: string): void;
|
|
467
|
-
/**
|
|
468
|
-
* Checks if an `input` relative to the `base` can be parsed to a `URL`.
|
|
469
|
-
*
|
|
470
|
-
* ```js
|
|
471
|
-
* const isValid = URL.canParse('/foo', 'https://example.org/'); // true
|
|
472
|
-
*
|
|
473
|
-
* const isNotValid = URL.canParse('/foo'); // false
|
|
474
|
-
* ```
|
|
475
|
-
* @since v19.9.0
|
|
476
|
-
* @param input The absolute or relative input URL to parse. If `input` is relative, then `base` is required. If `input` is absolute, the `base` is ignored. If `input` is not a string, it is
|
|
477
|
-
* `converted to a string` first.
|
|
478
|
-
* @param base The base URL to resolve against if the `input` is not absolute. If `base` is not a string, it is `converted to a string` first.
|
|
479
|
-
*/
|
|
480
|
-
static canParse(input: string, base?: string): boolean;
|
|
481
|
-
/**
|
|
482
|
-
* Parses a string as a URL. If `base` is provided, it will be used as the base
|
|
483
|
-
* URL for the purpose of resolving non-absolute `input` URLs. Returns `null`
|
|
484
|
-
* if the parameters can't be resolved to a valid URL.
|
|
485
|
-
* @since v22.1.0
|
|
486
|
-
* @param input The absolute or relative input URL to parse. If `input`
|
|
487
|
-
* is relative, then `base` is required. If `input` is absolute, the `base`
|
|
488
|
-
* is ignored. If `input` is not a string, it is [converted to a string](https://tc39.es/ecma262/#sec-tostring) first.
|
|
489
|
-
* @param base The base URL to resolve against if the `input` is not
|
|
490
|
-
* absolute. If `base` is not a string, it is [converted to a string](https://tc39.es/ecma262/#sec-tostring) first.
|
|
491
|
-
*/
|
|
492
|
-
static parse(input: string, base?: string): URL | null;
|
|
493
|
-
constructor(input: string | { toString: () => string }, base?: string | URL);
|
|
494
|
-
/**
|
|
495
|
-
* Gets and sets the fragment portion of the URL.
|
|
496
|
-
*
|
|
497
|
-
* ```js
|
|
498
|
-
* const myURL = new URL('https://example.org/foo#bar');
|
|
499
|
-
* console.log(myURL.hash);
|
|
500
|
-
* // Prints #bar
|
|
501
|
-
*
|
|
502
|
-
* myURL.hash = 'baz';
|
|
503
|
-
* console.log(myURL.href);
|
|
504
|
-
* // Prints https://example.org/foo#baz
|
|
505
|
-
* ```
|
|
506
|
-
*
|
|
507
|
-
* Invalid URL characters included in the value assigned to the `hash` property
|
|
508
|
-
* are `percent-encoded`. The selection of which characters to
|
|
509
|
-
* percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
|
|
510
|
-
*/
|
|
511
|
-
hash: string;
|
|
512
|
-
/**
|
|
513
|
-
* Gets and sets the host portion of the URL.
|
|
514
|
-
*
|
|
515
|
-
* ```js
|
|
516
|
-
* const myURL = new URL('https://example.org:81/foo');
|
|
517
|
-
* console.log(myURL.host);
|
|
518
|
-
* // Prints example.org:81
|
|
519
|
-
*
|
|
520
|
-
* myURL.host = 'example.com:82';
|
|
521
|
-
* console.log(myURL.href);
|
|
522
|
-
* // Prints https://example.com:82/foo
|
|
523
|
-
* ```
|
|
524
|
-
*
|
|
525
|
-
* Invalid host values assigned to the `host` property are ignored.
|
|
526
|
-
*/
|
|
527
|
-
host: string;
|
|
528
|
-
/**
|
|
529
|
-
* Gets and sets the host name portion of the URL. The key difference between`url.host` and `url.hostname` is that `url.hostname` does _not_ include the
|
|
530
|
-
* port.
|
|
531
|
-
*
|
|
532
|
-
* ```js
|
|
533
|
-
* const myURL = new URL('https://example.org:81/foo');
|
|
534
|
-
* console.log(myURL.hostname);
|
|
535
|
-
* // Prints example.org
|
|
536
|
-
*
|
|
537
|
-
* // Setting the hostname does not change the port
|
|
538
|
-
* myURL.hostname = 'example.com';
|
|
539
|
-
* console.log(myURL.href);
|
|
540
|
-
* // Prints https://example.com:81/foo
|
|
541
|
-
*
|
|
542
|
-
* // Use myURL.host to change the hostname and port
|
|
543
|
-
* myURL.host = 'example.org:82';
|
|
544
|
-
* console.log(myURL.href);
|
|
545
|
-
* // Prints https://example.org:82/foo
|
|
546
|
-
* ```
|
|
547
|
-
*
|
|
548
|
-
* Invalid host name values assigned to the `hostname` property are ignored.
|
|
549
|
-
*/
|
|
550
|
-
hostname: string;
|
|
551
|
-
/**
|
|
552
|
-
* Gets and sets the serialized URL.
|
|
553
|
-
*
|
|
554
|
-
* ```js
|
|
555
|
-
* const myURL = new URL('https://example.org/foo');
|
|
556
|
-
* console.log(myURL.href);
|
|
557
|
-
* // Prints https://example.org/foo
|
|
558
|
-
*
|
|
559
|
-
* myURL.href = 'https://example.com/bar';
|
|
560
|
-
* console.log(myURL.href);
|
|
561
|
-
* // Prints https://example.com/bar
|
|
562
|
-
* ```
|
|
563
|
-
*
|
|
564
|
-
* Getting the value of the `href` property is equivalent to calling {@link toString}.
|
|
565
|
-
*
|
|
566
|
-
* Setting the value of this property to a new value is equivalent to creating a
|
|
567
|
-
* new `URL` object using `new URL(value)`. Each of the `URL` object's properties will be modified.
|
|
568
|
-
*
|
|
569
|
-
* If the value assigned to the `href` property is not a valid URL, a `TypeError` will be thrown.
|
|
570
|
-
*/
|
|
571
|
-
href: string;
|
|
572
|
-
/**
|
|
573
|
-
* Gets the read-only serialization of the URL's origin.
|
|
574
|
-
*
|
|
575
|
-
* ```js
|
|
576
|
-
* const myURL = new URL('https://example.org/foo/bar?baz');
|
|
577
|
-
* console.log(myURL.origin);
|
|
578
|
-
* // Prints https://example.org
|
|
579
|
-
* ```
|
|
580
|
-
*
|
|
581
|
-
* ```js
|
|
582
|
-
* const idnURL = new URL('https://測試');
|
|
583
|
-
* console.log(idnURL.origin);
|
|
584
|
-
* // Prints https://xn--g6w251d
|
|
585
|
-
*
|
|
586
|
-
* console.log(idnURL.hostname);
|
|
587
|
-
* // Prints xn--g6w251d
|
|
588
|
-
* ```
|
|
589
|
-
*/
|
|
590
|
-
readonly origin: string;
|
|
591
|
-
/**
|
|
592
|
-
* Gets and sets the password portion of the URL.
|
|
593
|
-
*
|
|
594
|
-
* ```js
|
|
595
|
-
* const myURL = new URL('https://abc:xyz@example.com');
|
|
596
|
-
* console.log(myURL.password);
|
|
597
|
-
* // Prints xyz
|
|
598
|
-
*
|
|
599
|
-
* myURL.password = '123';
|
|
600
|
-
* console.log(myURL.href);
|
|
601
|
-
* // Prints https://abc:123@example.com/
|
|
602
|
-
* ```
|
|
603
|
-
*
|
|
604
|
-
* Invalid URL characters included in the value assigned to the `password` property
|
|
605
|
-
* are `percent-encoded`. The selection of which characters to
|
|
606
|
-
* percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
|
|
607
|
-
*/
|
|
608
|
-
password: string;
|
|
609
|
-
/**
|
|
610
|
-
* Gets and sets the path portion of the URL.
|
|
611
|
-
*
|
|
612
|
-
* ```js
|
|
613
|
-
* const myURL = new URL('https://example.org/abc/xyz?123');
|
|
614
|
-
* console.log(myURL.pathname);
|
|
615
|
-
* // Prints /abc/xyz
|
|
616
|
-
*
|
|
617
|
-
* myURL.pathname = '/abcdef';
|
|
618
|
-
* console.log(myURL.href);
|
|
619
|
-
* // Prints https://example.org/abcdef?123
|
|
620
|
-
* ```
|
|
621
|
-
*
|
|
622
|
-
* Invalid URL characters included in the value assigned to the `pathname` property are `percent-encoded`. The selection of which characters
|
|
623
|
-
* to percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
|
|
624
|
-
*/
|
|
625
|
-
pathname: string;
|
|
626
|
-
/**
|
|
627
|
-
* Gets and sets the port portion of the URL.
|
|
628
|
-
*
|
|
629
|
-
* The port value may be a number or a string containing a number in the range `0` to `65535` (inclusive). Setting the value to the default port of the `URL` objects given `protocol` will
|
|
630
|
-
* result in the `port` value becoming
|
|
631
|
-
* the empty string (`''`).
|
|
632
|
-
*
|
|
633
|
-
* The port value can be an empty string in which case the port depends on
|
|
634
|
-
* the protocol/scheme:
|
|
635
|
-
*
|
|
636
|
-
* <omitted>
|
|
637
|
-
*
|
|
638
|
-
* Upon assigning a value to the port, the value will first be converted to a
|
|
639
|
-
* string using `.toString()`.
|
|
640
|
-
*
|
|
641
|
-
* If that string is invalid but it begins with a number, the leading number is
|
|
642
|
-
* assigned to `port`.
|
|
643
|
-
* If the number lies outside the range denoted above, it is ignored.
|
|
644
|
-
*
|
|
645
|
-
* ```js
|
|
646
|
-
* const myURL = new URL('https://example.org:8888');
|
|
647
|
-
* console.log(myURL.port);
|
|
648
|
-
* // Prints 8888
|
|
649
|
-
*
|
|
650
|
-
* // Default ports are automatically transformed to the empty string
|
|
651
|
-
* // (HTTPS protocol's default port is 443)
|
|
652
|
-
* myURL.port = '443';
|
|
653
|
-
* console.log(myURL.port);
|
|
654
|
-
* // Prints the empty string
|
|
655
|
-
* console.log(myURL.href);
|
|
656
|
-
* // Prints https://example.org/
|
|
657
|
-
*
|
|
658
|
-
* myURL.port = 1234;
|
|
659
|
-
* console.log(myURL.port);
|
|
660
|
-
* // Prints 1234
|
|
661
|
-
* console.log(myURL.href);
|
|
662
|
-
* // Prints https://example.org:1234/
|
|
663
|
-
*
|
|
664
|
-
* // Completely invalid port strings are ignored
|
|
665
|
-
* myURL.port = 'abcd';
|
|
666
|
-
* console.log(myURL.port);
|
|
667
|
-
* // Prints 1234
|
|
668
|
-
*
|
|
669
|
-
* // Leading numbers are treated as a port number
|
|
670
|
-
* myURL.port = '5678abcd';
|
|
671
|
-
* console.log(myURL.port);
|
|
672
|
-
* // Prints 5678
|
|
673
|
-
*
|
|
674
|
-
* // Non-integers are truncated
|
|
675
|
-
* myURL.port = 1234.5678;
|
|
676
|
-
* console.log(myURL.port);
|
|
677
|
-
* // Prints 1234
|
|
678
|
-
*
|
|
679
|
-
* // Out-of-range numbers which are not represented in scientific notation
|
|
680
|
-
* // will be ignored.
|
|
681
|
-
* myURL.port = 1e10; // 10000000000, will be range-checked as described below
|
|
682
|
-
* console.log(myURL.port);
|
|
683
|
-
* // Prints 1234
|
|
684
|
-
* ```
|
|
685
|
-
*
|
|
686
|
-
* Numbers which contain a decimal point,
|
|
687
|
-
* such as floating-point numbers or numbers in scientific notation,
|
|
688
|
-
* are not an exception to this rule.
|
|
689
|
-
* Leading numbers up to the decimal point will be set as the URL's port,
|
|
690
|
-
* assuming they are valid:
|
|
691
|
-
*
|
|
692
|
-
* ```js
|
|
693
|
-
* myURL.port = 4.567e21;
|
|
694
|
-
* console.log(myURL.port);
|
|
695
|
-
* // Prints 4 (because it is the leading number in the string '4.567e21')
|
|
696
|
-
* ```
|
|
697
|
-
*/
|
|
698
|
-
port: string;
|
|
699
|
-
/**
|
|
700
|
-
* Gets and sets the protocol portion of the URL.
|
|
701
|
-
*
|
|
702
|
-
* ```js
|
|
703
|
-
* const myURL = new URL('https://example.org');
|
|
704
|
-
* console.log(myURL.protocol);
|
|
705
|
-
* // Prints https:
|
|
706
|
-
*
|
|
707
|
-
* myURL.protocol = 'ftp';
|
|
708
|
-
* console.log(myURL.href);
|
|
709
|
-
* // Prints ftp://example.org/
|
|
710
|
-
* ```
|
|
711
|
-
*
|
|
712
|
-
* Invalid URL protocol values assigned to the `protocol` property are ignored.
|
|
713
|
-
*/
|
|
714
|
-
protocol: string;
|
|
715
|
-
/**
|
|
716
|
-
* Gets and sets the serialized query portion of the URL.
|
|
717
|
-
*
|
|
718
|
-
* ```js
|
|
719
|
-
* const myURL = new URL('https://example.org/abc?123');
|
|
720
|
-
* console.log(myURL.search);
|
|
721
|
-
* // Prints ?123
|
|
722
|
-
*
|
|
723
|
-
* myURL.search = 'abc=xyz';
|
|
724
|
-
* console.log(myURL.href);
|
|
725
|
-
* // Prints https://example.org/abc?abc=xyz
|
|
726
|
-
* ```
|
|
727
|
-
*
|
|
728
|
-
* Any invalid URL characters appearing in the value assigned the `search` property will be `percent-encoded`. The selection of which
|
|
729
|
-
* characters to percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
|
|
730
|
-
*/
|
|
731
|
-
search: string;
|
|
732
|
-
/**
|
|
733
|
-
* Gets the `URLSearchParams` object representing the query parameters of the
|
|
734
|
-
* URL. This property is read-only but the `URLSearchParams` object it provides
|
|
735
|
-
* can be used to mutate the URL instance; to replace the entirety of query
|
|
736
|
-
* parameters of the URL, use the {@link search} setter. See `URLSearchParams` documentation for details.
|
|
737
|
-
*
|
|
738
|
-
* Use care when using `.searchParams` to modify the `URL` because,
|
|
739
|
-
* per the WHATWG specification, the `URLSearchParams` object uses
|
|
740
|
-
* different rules to determine which characters to percent-encode. For
|
|
741
|
-
* instance, the `URL` object will not percent encode the ASCII tilde (`~`)
|
|
742
|
-
* character, while `URLSearchParams` will always encode it:
|
|
743
|
-
*
|
|
744
|
-
* ```js
|
|
745
|
-
* const myURL = new URL('https://example.org/abc?foo=~bar');
|
|
746
|
-
*
|
|
747
|
-
* console.log(myURL.search); // prints ?foo=~bar
|
|
748
|
-
*
|
|
749
|
-
* // Modify the URL via searchParams...
|
|
750
|
-
* myURL.searchParams.sort();
|
|
751
|
-
*
|
|
752
|
-
* console.log(myURL.search); // prints ?foo=%7Ebar
|
|
753
|
-
* ```
|
|
754
|
-
*/
|
|
755
|
-
readonly searchParams: URLSearchParams;
|
|
756
|
-
/**
|
|
757
|
-
* Gets and sets the username portion of the URL.
|
|
758
|
-
*
|
|
759
|
-
* ```js
|
|
760
|
-
* const myURL = new URL('https://abc:xyz@example.com');
|
|
761
|
-
* console.log(myURL.username);
|
|
762
|
-
* // Prints abc
|
|
763
|
-
*
|
|
764
|
-
* myURL.username = '123';
|
|
765
|
-
* console.log(myURL.href);
|
|
766
|
-
* // Prints https://123:xyz@example.com/
|
|
767
|
-
* ```
|
|
768
|
-
*
|
|
769
|
-
* Any invalid URL characters appearing in the value assigned the `username` property will be `percent-encoded`. The selection of which
|
|
770
|
-
* characters to percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
|
|
771
|
-
*/
|
|
772
|
-
username: string;
|
|
773
|
-
/**
|
|
774
|
-
* The `toString()` method on the `URL` object returns the serialized URL. The
|
|
775
|
-
* value returned is equivalent to that of {@link href} and {@link toJSON}.
|
|
776
|
-
*/
|
|
777
|
-
toString(): string;
|
|
778
|
-
/**
|
|
779
|
-
* The `toJSON()` method on the `URL` object returns the serialized URL. The
|
|
780
|
-
* value returned is equivalent to that of {@link href} and {@link toString}.
|
|
781
|
-
*
|
|
782
|
-
* This method is automatically called when an `URL` object is serialized
|
|
783
|
-
* with [`JSON.stringify()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify).
|
|
784
|
-
*
|
|
785
|
-
* ```js
|
|
786
|
-
* const myURLs = [
|
|
787
|
-
* new URL('https://www.example.com'),
|
|
788
|
-
* new URL('https://test.example.org'),
|
|
789
|
-
* ];
|
|
790
|
-
* console.log(JSON.stringify(myURLs));
|
|
791
|
-
* // Prints ["https://www.example.com/","https://test.example.org/"]
|
|
792
|
-
* ```
|
|
793
|
-
*/
|
|
794
|
-
toJSON(): string;
|
|
795
|
-
}
|
|
421
|
+
// #region web types
|
|
422
|
+
type URLPatternInput = string | URLPatternInit;
|
|
796
423
|
interface URLPatternComponentResult {
|
|
797
424
|
input: string;
|
|
798
425
|
groups: Record<string, string | undefined>;
|
|
@@ -812,7 +439,7 @@ declare module "url" {
|
|
|
812
439
|
ignoreCase?: boolean;
|
|
813
440
|
}
|
|
814
441
|
interface URLPatternResult {
|
|
815
|
-
inputs:
|
|
442
|
+
inputs: URLPatternInput[];
|
|
816
443
|
protocol: URLPatternComponentResult;
|
|
817
444
|
username: URLPatternComponentResult;
|
|
818
445
|
password: URLPatternComponentResult;
|
|
@@ -822,14 +449,30 @@ declare module "url" {
|
|
|
822
449
|
search: URLPatternComponentResult;
|
|
823
450
|
hash: URLPatternComponentResult;
|
|
824
451
|
}
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
|
|
452
|
+
interface URL {
|
|
453
|
+
hash: string;
|
|
454
|
+
host: string;
|
|
455
|
+
hostname: string;
|
|
456
|
+
href: string;
|
|
457
|
+
readonly origin: string;
|
|
458
|
+
password: string;
|
|
459
|
+
pathname: string;
|
|
460
|
+
port: string;
|
|
461
|
+
protocol: string;
|
|
462
|
+
search: string;
|
|
463
|
+
readonly searchParams: URLSearchParams;
|
|
464
|
+
username: string;
|
|
465
|
+
toJSON(): string;
|
|
466
|
+
}
|
|
467
|
+
var URL: {
|
|
468
|
+
prototype: URL;
|
|
469
|
+
new(url: string | URL, base?: string | URL): URL;
|
|
470
|
+
canParse(input: string | URL, base?: string | URL): boolean;
|
|
471
|
+
createObjectURL(blob: Blob): string;
|
|
472
|
+
parse(input: string | URL, base?: string | URL): URL | null;
|
|
473
|
+
revokeObjectURL(id: string): void;
|
|
474
|
+
};
|
|
475
|
+
interface URLPattern {
|
|
833
476
|
readonly hasRegExpGroups: boolean;
|
|
834
477
|
readonly hash: string;
|
|
835
478
|
readonly hostname: string;
|
|
@@ -838,220 +481,39 @@ declare module "url" {
|
|
|
838
481
|
readonly port: string;
|
|
839
482
|
readonly protocol: string;
|
|
840
483
|
readonly search: string;
|
|
841
|
-
test(input?: string | URLPatternInit, baseURL?: string): boolean;
|
|
842
484
|
readonly username: string;
|
|
485
|
+
exec(input?: URLPatternInput, baseURL?: string | URL): URLPatternResult | null;
|
|
486
|
+
test(input?: URLPatternInput, baseURL?: string | URL): boolean;
|
|
843
487
|
}
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
*
|
|
852
|
-
* The WHATWG `URLSearchParams` interface and the `querystring` module have
|
|
853
|
-
* similar purpose, but the purpose of the `querystring` module is more
|
|
854
|
-
* general, as it allows the customization of delimiter characters (`&` and `=`).
|
|
855
|
-
* On the other hand, this API is designed purely for URL query strings.
|
|
856
|
-
*
|
|
857
|
-
* ```js
|
|
858
|
-
* const myURL = new URL('https://example.org/?abc=123');
|
|
859
|
-
* console.log(myURL.searchParams.get('abc'));
|
|
860
|
-
* // Prints 123
|
|
861
|
-
*
|
|
862
|
-
* myURL.searchParams.append('abc', 'xyz');
|
|
863
|
-
* console.log(myURL.href);
|
|
864
|
-
* // Prints https://example.org/?abc=123&abc=xyz
|
|
865
|
-
*
|
|
866
|
-
* myURL.searchParams.delete('abc');
|
|
867
|
-
* myURL.searchParams.set('a', 'b');
|
|
868
|
-
* console.log(myURL.href);
|
|
869
|
-
* // Prints https://example.org/?a=b
|
|
870
|
-
*
|
|
871
|
-
* const newSearchParams = new URLSearchParams(myURL.searchParams);
|
|
872
|
-
* // The above is equivalent to
|
|
873
|
-
* // const newSearchParams = new URLSearchParams(myURL.search);
|
|
874
|
-
*
|
|
875
|
-
* newSearchParams.append('a', 'c');
|
|
876
|
-
* console.log(myURL.href);
|
|
877
|
-
* // Prints https://example.org/?a=b
|
|
878
|
-
* console.log(newSearchParams.toString());
|
|
879
|
-
* // Prints a=b&a=c
|
|
880
|
-
*
|
|
881
|
-
* // newSearchParams.toString() is implicitly called
|
|
882
|
-
* myURL.search = newSearchParams;
|
|
883
|
-
* console.log(myURL.href);
|
|
884
|
-
* // Prints https://example.org/?a=b&a=c
|
|
885
|
-
* newSearchParams.delete('a');
|
|
886
|
-
* console.log(myURL.href);
|
|
887
|
-
* // Prints https://example.org/?a=b&a=c
|
|
888
|
-
* ```
|
|
889
|
-
* @since v7.5.0, v6.13.0
|
|
890
|
-
*/
|
|
891
|
-
class URLSearchParams implements Iterable<[string, string]> {
|
|
892
|
-
constructor(
|
|
893
|
-
init?:
|
|
894
|
-
| URLSearchParams
|
|
895
|
-
| string
|
|
896
|
-
| Record<string, string | readonly string[]>
|
|
897
|
-
| Iterable<[string, string]>
|
|
898
|
-
| ReadonlyArray<[string, string]>,
|
|
899
|
-
);
|
|
900
|
-
/**
|
|
901
|
-
* Append a new name-value pair to the query string.
|
|
902
|
-
*/
|
|
488
|
+
var URLPattern: {
|
|
489
|
+
prototype: URLPattern;
|
|
490
|
+
new(input: URLPatternInput, baseURL: string | URL, options?: URLPatternOptions): URLPattern;
|
|
491
|
+
new(input?: URLPatternInput, options?: URLPatternOptions): URLPattern;
|
|
492
|
+
};
|
|
493
|
+
interface URLSearchParams {
|
|
494
|
+
readonly size: number;
|
|
903
495
|
append(name: string, value: string): void;
|
|
904
|
-
/**
|
|
905
|
-
* If `value` is provided, removes all name-value pairs
|
|
906
|
-
* where name is `name` and value is `value`.
|
|
907
|
-
*
|
|
908
|
-
* If `value` is not provided, removes all name-value pairs whose name is `name`.
|
|
909
|
-
*/
|
|
910
496
|
delete(name: string, value?: string): void;
|
|
911
|
-
/**
|
|
912
|
-
* Returns an ES6 `Iterator` over each of the name-value pairs in the query.
|
|
913
|
-
* Each item of the iterator is a JavaScript `Array`. The first item of the `Array` is the `name`, the second item of the `Array` is the `value`.
|
|
914
|
-
*
|
|
915
|
-
* Alias for `urlSearchParams[Symbol.iterator]()`.
|
|
916
|
-
*/
|
|
917
|
-
entries(): URLSearchParamsIterator<[string, string]>;
|
|
918
|
-
/**
|
|
919
|
-
* Iterates over each name-value pair in the query and invokes the given function.
|
|
920
|
-
*
|
|
921
|
-
* ```js
|
|
922
|
-
* const myURL = new URL('https://example.org/?a=b&c=d');
|
|
923
|
-
* myURL.searchParams.forEach((value, name, searchParams) => {
|
|
924
|
-
* console.log(name, value, myURL.searchParams === searchParams);
|
|
925
|
-
* });
|
|
926
|
-
* // Prints:
|
|
927
|
-
* // a b true
|
|
928
|
-
* // c d true
|
|
929
|
-
* ```
|
|
930
|
-
* @param fn Invoked for each name-value pair in the query
|
|
931
|
-
* @param thisArg To be used as `this` value for when `fn` is called
|
|
932
|
-
*/
|
|
933
|
-
forEach<TThis = this>(
|
|
934
|
-
fn: (this: TThis, value: string, name: string, searchParams: URLSearchParams) => void,
|
|
935
|
-
thisArg?: TThis,
|
|
936
|
-
): void;
|
|
937
|
-
/**
|
|
938
|
-
* Returns the value of the first name-value pair whose name is `name`. If there
|
|
939
|
-
* are no such pairs, `null` is returned.
|
|
940
|
-
* @return or `null` if there is no name-value pair with the given `name`.
|
|
941
|
-
*/
|
|
942
497
|
get(name: string): string | null;
|
|
943
|
-
/**
|
|
944
|
-
* Returns the values of all name-value pairs whose name is `name`. If there are
|
|
945
|
-
* no such pairs, an empty array is returned.
|
|
946
|
-
*/
|
|
947
498
|
getAll(name: string): string[];
|
|
948
|
-
/**
|
|
949
|
-
* Checks if the `URLSearchParams` object contains key-value pair(s) based on `name` and an optional `value` argument.
|
|
950
|
-
*
|
|
951
|
-
* If `value` is provided, returns `true` when name-value pair with
|
|
952
|
-
* same `name` and `value` exists.
|
|
953
|
-
*
|
|
954
|
-
* If `value` is not provided, returns `true` if there is at least one name-value
|
|
955
|
-
* pair whose name is `name`.
|
|
956
|
-
*/
|
|
957
499
|
has(name: string, value?: string): boolean;
|
|
958
|
-
/**
|
|
959
|
-
* Returns an ES6 `Iterator` over the names of each name-value pair.
|
|
960
|
-
*
|
|
961
|
-
* ```js
|
|
962
|
-
* const params = new URLSearchParams('foo=bar&foo=baz');
|
|
963
|
-
* for (const name of params.keys()) {
|
|
964
|
-
* console.log(name);
|
|
965
|
-
* }
|
|
966
|
-
* // Prints:
|
|
967
|
-
* // foo
|
|
968
|
-
* // foo
|
|
969
|
-
* ```
|
|
970
|
-
*/
|
|
971
|
-
keys(): URLSearchParamsIterator<string>;
|
|
972
|
-
/**
|
|
973
|
-
* Sets the value in the `URLSearchParams` object associated with `name` to `value`. If there are any pre-existing name-value pairs whose names are `name`,
|
|
974
|
-
* set the first such pair's value to `value` and remove all others. If not,
|
|
975
|
-
* append the name-value pair to the query string.
|
|
976
|
-
*
|
|
977
|
-
* ```js
|
|
978
|
-
* const params = new URLSearchParams();
|
|
979
|
-
* params.append('foo', 'bar');
|
|
980
|
-
* params.append('foo', 'baz');
|
|
981
|
-
* params.append('abc', 'def');
|
|
982
|
-
* console.log(params.toString());
|
|
983
|
-
* // Prints foo=bar&foo=baz&abc=def
|
|
984
|
-
*
|
|
985
|
-
* params.set('foo', 'def');
|
|
986
|
-
* params.set('xyz', 'opq');
|
|
987
|
-
* console.log(params.toString());
|
|
988
|
-
* // Prints foo=def&abc=def&xyz=opq
|
|
989
|
-
* ```
|
|
990
|
-
*/
|
|
991
500
|
set(name: string, value: string): void;
|
|
992
|
-
/**
|
|
993
|
-
* The total number of parameter entries.
|
|
994
|
-
* @since v19.8.0
|
|
995
|
-
*/
|
|
996
|
-
readonly size: number;
|
|
997
|
-
/**
|
|
998
|
-
* Sort all existing name-value pairs in-place by their names. Sorting is done
|
|
999
|
-
* with a [stable sorting algorithm](https://en.wikipedia.org/wiki/Sorting_algorithm#Stability), so relative order between name-value pairs
|
|
1000
|
-
* with the same name is preserved.
|
|
1001
|
-
*
|
|
1002
|
-
* This method can be used, in particular, to increase cache hits.
|
|
1003
|
-
*
|
|
1004
|
-
* ```js
|
|
1005
|
-
* const params = new URLSearchParams('query[]=abc&type=search&query[]=123');
|
|
1006
|
-
* params.sort();
|
|
1007
|
-
* console.log(params.toString());
|
|
1008
|
-
* // Prints query%5B%5D=abc&query%5B%5D=123&type=search
|
|
1009
|
-
* ```
|
|
1010
|
-
* @since v7.7.0, v6.13.0
|
|
1011
|
-
*/
|
|
1012
501
|
sort(): void;
|
|
1013
|
-
|
|
1014
|
-
* Returns the search parameters serialized as a string, with characters
|
|
1015
|
-
* percent-encoded where necessary.
|
|
1016
|
-
*/
|
|
1017
|
-
toString(): string;
|
|
1018
|
-
/**
|
|
1019
|
-
* Returns an ES6 `Iterator` over the values of each name-value pair.
|
|
1020
|
-
*/
|
|
1021
|
-
values(): URLSearchParamsIterator<string>;
|
|
502
|
+
forEach(callbackfn: (value: string, key: string, parent: URLSearchParams) => void, thisArg?: any): void;
|
|
1022
503
|
[Symbol.iterator](): URLSearchParamsIterator<[string, string]>;
|
|
504
|
+
entries(): URLSearchParamsIterator<[string, string]>;
|
|
505
|
+
keys(): URLSearchParamsIterator<string>;
|
|
506
|
+
values(): URLSearchParamsIterator<string>;
|
|
1023
507
|
}
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
} from "url";
|
|
1031
|
-
global {
|
|
1032
|
-
interface URL extends _URL {}
|
|
1033
|
-
var URL: typeof globalThis extends {
|
|
1034
|
-
onmessage: any;
|
|
1035
|
-
URL: infer T;
|
|
1036
|
-
} ? T
|
|
1037
|
-
: typeof _URL;
|
|
1038
|
-
interface URLSearchParams extends _URLSearchParams {}
|
|
1039
|
-
var URLSearchParams: typeof globalThis extends {
|
|
1040
|
-
onmessage: any;
|
|
1041
|
-
URLSearchParams: infer T;
|
|
1042
|
-
} ? T
|
|
1043
|
-
: typeof _URLSearchParams;
|
|
1044
|
-
interface URLPatternInit extends _URLPatternInit {}
|
|
1045
|
-
interface URLPatternResult extends _URLPatternResult {}
|
|
1046
|
-
interface URLPattern extends _URLPattern {}
|
|
1047
|
-
var URLPattern: typeof globalThis extends {
|
|
1048
|
-
onmessage: any;
|
|
1049
|
-
scheduler: any; // Must be a var introduced at the same time as URLPattern.
|
|
1050
|
-
URLPattern: infer T;
|
|
1051
|
-
} ? T
|
|
1052
|
-
: typeof _URLPattern;
|
|
508
|
+
var URLSearchParams: {
|
|
509
|
+
prototype: URLSearchParams;
|
|
510
|
+
new(init?: string[][] | Record<string, string> | string | URLSearchParams): URLSearchParams;
|
|
511
|
+
};
|
|
512
|
+
interface URLSearchParamsIterator<T> extends NodeJS.Iterator<T, NodeJS.BuiltinIteratorReturn, unknown> {
|
|
513
|
+
[Symbol.iterator](): URLSearchParamsIterator<T>;
|
|
1053
514
|
}
|
|
515
|
+
// #endregion
|
|
1054
516
|
}
|
|
1055
|
-
declare module "
|
|
1056
|
-
export * from "url";
|
|
517
|
+
declare module "url" {
|
|
518
|
+
export * from "node:url";
|
|
1057
519
|
}
|