mirror of
https://github.com/nodejs/node.git
synced 2024-12-01 16:10:02 +01:00
39f4158bc3
This encapsulates the Node.js errors more by adding extra properties to an error inside of the function to create the error message instead of adding the properties at the call site. That simplifies the usage of our errors and makes sure the expected properties are always set. PR-URL: https://github.com/nodejs/node/pull/26752 Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>
1427 lines
39 KiB
JavaScript
1427 lines
39 KiB
JavaScript
'use strict';
|
|
|
|
const util = require('util');
|
|
const {
|
|
encodeStr,
|
|
hexTable,
|
|
isHexTable
|
|
} = require('internal/querystring');
|
|
|
|
const { getConstructorOf, removeColors } = require('internal/util');
|
|
const {
|
|
ERR_ARG_NOT_ITERABLE,
|
|
ERR_INVALID_ARG_TYPE,
|
|
ERR_INVALID_CALLBACK,
|
|
ERR_INVALID_FILE_URL_HOST,
|
|
ERR_INVALID_FILE_URL_PATH,
|
|
ERR_INVALID_THIS,
|
|
ERR_INVALID_TUPLE,
|
|
ERR_INVALID_URL,
|
|
ERR_INVALID_URL_SCHEME,
|
|
ERR_MISSING_ARGS
|
|
} = require('internal/errors').codes;
|
|
const {
|
|
CHAR_AMPERSAND,
|
|
CHAR_BACKWARD_SLASH,
|
|
CHAR_EQUAL,
|
|
CHAR_FORWARD_SLASH,
|
|
CHAR_LOWERCASE_A,
|
|
CHAR_LOWERCASE_Z,
|
|
CHAR_PERCENT,
|
|
CHAR_PLUS
|
|
} = require('internal/constants');
|
|
const path = require('path');
|
|
|
|
// Lazy loaded for startup performance.
|
|
let querystring;
|
|
|
|
const { platform } = process;
|
|
const isWindows = platform === 'win32';
|
|
|
|
const {
|
|
domainToASCII: _domainToASCII,
|
|
domainToUnicode: _domainToUnicode,
|
|
encodeAuth,
|
|
toUSVString: _toUSVString,
|
|
parse,
|
|
setURLConstructor,
|
|
URL_FLAGS_CANNOT_BE_BASE,
|
|
URL_FLAGS_HAS_FRAGMENT,
|
|
URL_FLAGS_HAS_HOST,
|
|
URL_FLAGS_HAS_PASSWORD,
|
|
URL_FLAGS_HAS_PATH,
|
|
URL_FLAGS_HAS_QUERY,
|
|
URL_FLAGS_HAS_USERNAME,
|
|
URL_FLAGS_IS_DEFAULT_SCHEME_PORT,
|
|
URL_FLAGS_SPECIAL,
|
|
kFragment,
|
|
kHost,
|
|
kHostname,
|
|
kPathStart,
|
|
kPort,
|
|
kQuery,
|
|
kSchemeStart
|
|
} = internalBinding('url');
|
|
|
|
const context = Symbol('context');
|
|
const cannotBeBase = Symbol('cannot-be-base');
|
|
const cannotHaveUsernamePasswordPort =
|
|
Symbol('cannot-have-username-password-port');
|
|
const special = Symbol('special');
|
|
const searchParams = Symbol('query');
|
|
const kFormat = Symbol('format');
|
|
|
|
// https://tc39.github.io/ecma262/#sec-%iteratorprototype%-object
|
|
const IteratorPrototype = Object.getPrototypeOf(
|
|
Object.getPrototypeOf([][Symbol.iterator]())
|
|
);
|
|
|
|
const unpairedSurrogateRe =
|
|
/(?:[^\uD800-\uDBFF]|^)[\uDC00-\uDFFF]|[\uD800-\uDBFF](?![\uDC00-\uDFFF])/;
|
|
function toUSVString(val) {
|
|
const str = `${val}`;
|
|
// As of V8 5.5, `str.search()` (and `unpairedSurrogateRe[@@search]()`) are
|
|
// slower than `unpairedSurrogateRe.exec()`.
|
|
const match = unpairedSurrogateRe.exec(str);
|
|
if (!match)
|
|
return str;
|
|
return _toUSVString(str, match.index);
|
|
}
|
|
|
|
// Refs: https://html.spec.whatwg.org/multipage/browsers.html#concept-origin-opaque
|
|
const kOpaqueOrigin = 'null';
|
|
|
|
// Refs: https://html.spec.whatwg.org/multipage/browsers.html#ascii-serialisation-of-an-origin
|
|
function serializeTupleOrigin(scheme, host, port) {
|
|
return `${scheme}//${host}${port === null ? '' : `:${port}`}`;
|
|
}
|
|
|
|
// This class provides the internal state of a URL object. An instance of this
|
|
// class is stored in every URL object and is accessed internally by setters
|
|
// and getters. It roughly corresponds to the concept of a URL record in the
|
|
// URL Standard, with a few differences. It is also the object transported to
|
|
// the C++ binding.
|
|
// Refs: https://url.spec.whatwg.org/#concept-url
|
|
class URLContext {
|
|
constructor() {
|
|
this.flags = 0;
|
|
this.scheme = ':';
|
|
this.username = '';
|
|
this.password = '';
|
|
this.host = null;
|
|
this.port = null;
|
|
this.path = [];
|
|
this.query = null;
|
|
this.fragment = null;
|
|
}
|
|
}
|
|
|
|
class URLSearchParams {
|
|
// URL Standard says the default value is '', but as undefined and '' have
|
|
// the same result, undefined is used to prevent unnecessary parsing.
|
|
// Default parameter is necessary to keep URLSearchParams.length === 0 in
|
|
// accordance with Web IDL spec.
|
|
constructor(init = undefined) {
|
|
if (init === null || init === undefined) {
|
|
this[searchParams] = [];
|
|
} else if (typeof init === 'object' || typeof init === 'function') {
|
|
const method = init[Symbol.iterator];
|
|
if (method === this[Symbol.iterator]) {
|
|
// While the spec does not have this branch, we can use it as a
|
|
// shortcut to avoid having to go through the costly generic iterator.
|
|
const childParams = init[searchParams];
|
|
this[searchParams] = childParams.slice();
|
|
} else if (method !== null && method !== undefined) {
|
|
if (typeof method !== 'function') {
|
|
throw new ERR_ARG_NOT_ITERABLE('Query pairs');
|
|
}
|
|
|
|
// sequence<sequence<USVString>>
|
|
// Note: per spec we have to first exhaust the lists then process them
|
|
const pairs = [];
|
|
for (const pair of init) {
|
|
if ((typeof pair !== 'object' && typeof pair !== 'function') ||
|
|
pair === null ||
|
|
typeof pair[Symbol.iterator] !== 'function') {
|
|
throw new ERR_INVALID_TUPLE('Each query pair', '[name, value]');
|
|
}
|
|
const convertedPair = [];
|
|
for (const element of pair)
|
|
convertedPair.push(toUSVString(element));
|
|
pairs.push(convertedPair);
|
|
}
|
|
|
|
this[searchParams] = [];
|
|
for (const pair of pairs) {
|
|
if (pair.length !== 2) {
|
|
throw new ERR_INVALID_TUPLE('Each query pair', '[name, value]');
|
|
}
|
|
this[searchParams].push(pair[0], pair[1]);
|
|
}
|
|
} else {
|
|
// record<USVString, USVString>
|
|
// Need to use reflection APIs for full spec compliance.
|
|
this[searchParams] = [];
|
|
const keys = Reflect.ownKeys(init);
|
|
for (var i = 0; i < keys.length; i++) {
|
|
const key = keys[i];
|
|
const desc = Reflect.getOwnPropertyDescriptor(init, key);
|
|
if (desc !== undefined && desc.enumerable) {
|
|
const typedKey = toUSVString(key);
|
|
const typedValue = toUSVString(init[key]);
|
|
this[searchParams].push(typedKey, typedValue);
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
// USVString
|
|
init = toUSVString(init);
|
|
if (init[0] === '?') init = init.slice(1);
|
|
initSearchParams(this, init);
|
|
}
|
|
|
|
// "associated url object"
|
|
this[context] = null;
|
|
}
|
|
|
|
[util.inspect.custom](recurseTimes, ctx) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
|
|
if (typeof recurseTimes === 'number' && recurseTimes < 0)
|
|
return ctx.stylize('[Object]', 'special');
|
|
|
|
var separator = ', ';
|
|
var innerOpts = { ...ctx };
|
|
if (recurseTimes !== null) {
|
|
innerOpts.depth = recurseTimes - 1;
|
|
}
|
|
var innerInspect = (v) => util.inspect(v, innerOpts);
|
|
|
|
var list = this[searchParams];
|
|
var output = [];
|
|
for (var i = 0; i < list.length; i += 2)
|
|
output.push(`${innerInspect(list[i])} => ${innerInspect(list[i + 1])}`);
|
|
|
|
var length = output.reduce(
|
|
(prev, cur) => prev + removeColors(cur).length + separator.length,
|
|
-separator.length
|
|
);
|
|
if (length > ctx.breakLength) {
|
|
return `${this.constructor.name} {\n ${output.join(',\n ')} }`;
|
|
} else if (output.length) {
|
|
return `${this.constructor.name} { ${output.join(separator)} }`;
|
|
} else {
|
|
return `${this.constructor.name} {}`;
|
|
}
|
|
}
|
|
}
|
|
|
|
function onParseComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
var ctx = this[context];
|
|
ctx.flags = flags;
|
|
ctx.scheme = protocol;
|
|
ctx.username = (flags & URL_FLAGS_HAS_USERNAME) !== 0 ? username : '';
|
|
ctx.password = (flags & URL_FLAGS_HAS_PASSWORD) !== 0 ? password : '';
|
|
ctx.port = port;
|
|
ctx.path = (flags & URL_FLAGS_HAS_PATH) !== 0 ? path : [];
|
|
ctx.query = query;
|
|
ctx.fragment = fragment;
|
|
ctx.host = host;
|
|
if (!this[searchParams]) { // invoked from URL constructor
|
|
this[searchParams] = new URLSearchParams();
|
|
this[searchParams][context] = this;
|
|
}
|
|
initSearchParams(this[searchParams], query);
|
|
}
|
|
|
|
function onParseError(flags, input) {
|
|
throw new ERR_INVALID_URL(input);
|
|
}
|
|
|
|
function onParseProtocolComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
const ctx = this[context];
|
|
if ((flags & URL_FLAGS_SPECIAL) !== 0) {
|
|
ctx.flags |= URL_FLAGS_SPECIAL;
|
|
} else {
|
|
ctx.flags &= ~URL_FLAGS_SPECIAL;
|
|
}
|
|
ctx.scheme = protocol;
|
|
ctx.port = port;
|
|
}
|
|
|
|
function onParseHostnameComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
const ctx = this[context];
|
|
if ((flags & URL_FLAGS_HAS_HOST) !== 0) {
|
|
ctx.host = host;
|
|
ctx.flags |= URL_FLAGS_HAS_HOST;
|
|
} else {
|
|
ctx.host = null;
|
|
ctx.flags &= ~URL_FLAGS_HAS_HOST;
|
|
}
|
|
}
|
|
|
|
function onParsePortComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
this[context].port = port;
|
|
}
|
|
|
|
function onParseHostComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
onParseHostnameComplete.apply(this, arguments);
|
|
if (port !== null || ((flags & URL_FLAGS_IS_DEFAULT_SCHEME_PORT) !== 0))
|
|
onParsePortComplete.apply(this, arguments);
|
|
}
|
|
|
|
function onParsePathComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
const ctx = this[context];
|
|
if ((flags & URL_FLAGS_HAS_PATH) !== 0) {
|
|
ctx.path = path;
|
|
ctx.flags |= URL_FLAGS_HAS_PATH;
|
|
} else {
|
|
ctx.path = [];
|
|
ctx.flags &= ~URL_FLAGS_HAS_PATH;
|
|
}
|
|
|
|
// The C++ binding may set host to empty string.
|
|
if ((flags & URL_FLAGS_HAS_HOST) !== 0) {
|
|
ctx.host = host;
|
|
ctx.flags |= URL_FLAGS_HAS_HOST;
|
|
}
|
|
}
|
|
|
|
function onParseSearchComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
this[context].query = query;
|
|
}
|
|
|
|
function onParseHashComplete(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
this[context].fragment = fragment;
|
|
}
|
|
|
|
class URL {
|
|
constructor(input, base) {
|
|
// toUSVString is not needed.
|
|
input = `${input}`;
|
|
let base_context;
|
|
if (base !== undefined) {
|
|
base_context = new URL(base)[context];
|
|
}
|
|
this[context] = new URLContext();
|
|
parse(input, -1, base_context, undefined, onParseComplete.bind(this),
|
|
onParseError);
|
|
}
|
|
|
|
get [special]() {
|
|
return (this[context].flags & URL_FLAGS_SPECIAL) !== 0;
|
|
}
|
|
|
|
get [cannotBeBase]() {
|
|
return (this[context].flags & URL_FLAGS_CANNOT_BE_BASE) !== 0;
|
|
}
|
|
|
|
// https://url.spec.whatwg.org/#cannot-have-a-username-password-port
|
|
get [cannotHaveUsernamePasswordPort]() {
|
|
const { host, scheme } = this[context];
|
|
return ((host == null || host === '') ||
|
|
this[cannotBeBase] ||
|
|
scheme === 'file:');
|
|
}
|
|
|
|
[util.inspect.custom](depth, opts) {
|
|
if (this == null ||
|
|
Object.getPrototypeOf(this[context]) !== URLContext.prototype) {
|
|
throw new ERR_INVALID_THIS('URL');
|
|
}
|
|
|
|
if (typeof depth === 'number' && depth < 0)
|
|
return this;
|
|
|
|
var ctor = getConstructorOf(this);
|
|
|
|
var obj = Object.create({
|
|
constructor: ctor === null ? URL : ctor
|
|
});
|
|
|
|
obj.href = this.href;
|
|
obj.origin = this.origin;
|
|
obj.protocol = this.protocol;
|
|
obj.username = this.username;
|
|
obj.password = this.password;
|
|
obj.host = this.host;
|
|
obj.hostname = this.hostname;
|
|
obj.port = this.port;
|
|
obj.pathname = this.pathname;
|
|
obj.search = this.search;
|
|
obj.searchParams = this.searchParams;
|
|
obj.hash = this.hash;
|
|
|
|
if (opts.showHidden) {
|
|
obj.cannotBeBase = this[cannotBeBase];
|
|
obj.special = this[special];
|
|
obj[context] = this[context];
|
|
}
|
|
|
|
return util.inspect(obj, opts);
|
|
}
|
|
}
|
|
|
|
Object.defineProperties(URL.prototype, {
|
|
[kFormat]: {
|
|
enumerable: false,
|
|
configurable: false,
|
|
// eslint-disable-next-line func-name-matching
|
|
value: function format(options) {
|
|
if (options && typeof options !== 'object')
|
|
throw new ERR_INVALID_ARG_TYPE('options', 'Object', options);
|
|
options = {
|
|
fragment: true,
|
|
unicode: false,
|
|
search: true,
|
|
auth: true,
|
|
...options
|
|
};
|
|
const ctx = this[context];
|
|
var ret = ctx.scheme;
|
|
if (ctx.host !== null) {
|
|
ret += '//';
|
|
const has_username = ctx.username !== '';
|
|
const has_password = ctx.password !== '';
|
|
if (options.auth && (has_username || has_password)) {
|
|
if (has_username)
|
|
ret += ctx.username;
|
|
if (has_password)
|
|
ret += `:${ctx.password}`;
|
|
ret += '@';
|
|
}
|
|
ret += options.unicode ?
|
|
domainToUnicode(this.hostname) : this.hostname;
|
|
if (ctx.port !== null)
|
|
ret += `:${ctx.port}`;
|
|
} else if (ctx.scheme === 'file:') {
|
|
ret += '//';
|
|
}
|
|
if (this.pathname)
|
|
ret += this.pathname;
|
|
if (options.search && ctx.query !== null)
|
|
ret += `?${ctx.query}`;
|
|
if (options.fragment && ctx.fragment !== null)
|
|
ret += `#${ctx.fragment}`;
|
|
return ret;
|
|
}
|
|
},
|
|
[Symbol.toStringTag]: {
|
|
configurable: true,
|
|
value: 'URL'
|
|
},
|
|
toString: {
|
|
// https://heycam.github.io/webidl/#es-stringifier
|
|
writable: true,
|
|
enumerable: true,
|
|
configurable: true,
|
|
// eslint-disable-next-line func-name-matching
|
|
value: function toString() {
|
|
return this[kFormat]({});
|
|
}
|
|
},
|
|
href: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
return this[kFormat]({});
|
|
},
|
|
set(input) {
|
|
// toUSVString is not needed.
|
|
input = `${input}`;
|
|
parse(input, -1, undefined, undefined, onParseComplete.bind(this),
|
|
onParseError);
|
|
}
|
|
},
|
|
origin: { // readonly
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
// Refs: https://url.spec.whatwg.org/#concept-url-origin
|
|
const ctx = this[context];
|
|
switch (ctx.scheme) {
|
|
case 'blob:':
|
|
if (ctx.path.length > 0) {
|
|
try {
|
|
return (new URL(ctx.path[0])).origin;
|
|
} catch {
|
|
// fall through... do nothing
|
|
}
|
|
}
|
|
return kOpaqueOrigin;
|
|
case 'ftp:':
|
|
case 'gopher:':
|
|
case 'http:':
|
|
case 'https:':
|
|
case 'ws:':
|
|
case 'wss:':
|
|
return serializeTupleOrigin(ctx.scheme, ctx.host, ctx.port);
|
|
}
|
|
return kOpaqueOrigin;
|
|
}
|
|
},
|
|
protocol: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
return this[context].scheme;
|
|
},
|
|
set(scheme) {
|
|
// toUSVString is not needed.
|
|
scheme = `${scheme}`;
|
|
if (scheme.length === 0)
|
|
return;
|
|
const ctx = this[context];
|
|
if (ctx.scheme === 'file:' &&
|
|
(ctx.host === '' || ctx.host === null)) {
|
|
return;
|
|
}
|
|
parse(scheme, kSchemeStart, null, ctx,
|
|
onParseProtocolComplete.bind(this));
|
|
}
|
|
},
|
|
username: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
return this[context].username;
|
|
},
|
|
set(username) {
|
|
// toUSVString is not needed.
|
|
username = `${username}`;
|
|
if (this[cannotHaveUsernamePasswordPort])
|
|
return;
|
|
const ctx = this[context];
|
|
if (username === '') {
|
|
ctx.username = '';
|
|
ctx.flags &= ~URL_FLAGS_HAS_USERNAME;
|
|
return;
|
|
}
|
|
ctx.username = encodeAuth(username);
|
|
ctx.flags |= URL_FLAGS_HAS_USERNAME;
|
|
}
|
|
},
|
|
password: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
return this[context].password;
|
|
},
|
|
set(password) {
|
|
// toUSVString is not needed.
|
|
password = `${password}`;
|
|
if (this[cannotHaveUsernamePasswordPort])
|
|
return;
|
|
const ctx = this[context];
|
|
if (password === '') {
|
|
ctx.password = '';
|
|
ctx.flags &= ~URL_FLAGS_HAS_PASSWORD;
|
|
return;
|
|
}
|
|
ctx.password = encodeAuth(password);
|
|
ctx.flags |= URL_FLAGS_HAS_PASSWORD;
|
|
}
|
|
},
|
|
host: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
const ctx = this[context];
|
|
var ret = ctx.host || '';
|
|
if (ctx.port !== null)
|
|
ret += `:${ctx.port}`;
|
|
return ret;
|
|
},
|
|
set(host) {
|
|
const ctx = this[context];
|
|
// toUSVString is not needed.
|
|
host = `${host}`;
|
|
if (this[cannotBeBase]) {
|
|
// Cannot set the host if cannot-be-base is set
|
|
return;
|
|
}
|
|
parse(host, kHost, null, ctx, onParseHostComplete.bind(this));
|
|
}
|
|
},
|
|
hostname: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
return this[context].host || '';
|
|
},
|
|
set(host) {
|
|
const ctx = this[context];
|
|
// toUSVString is not needed.
|
|
host = `${host}`;
|
|
if (this[cannotBeBase]) {
|
|
// Cannot set the host if cannot-be-base is set
|
|
return;
|
|
}
|
|
parse(host, kHostname, null, ctx, onParseHostnameComplete.bind(this));
|
|
}
|
|
},
|
|
port: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
const port = this[context].port;
|
|
return port === null ? '' : String(port);
|
|
},
|
|
set(port) {
|
|
// toUSVString is not needed.
|
|
port = `${port}`;
|
|
if (this[cannotHaveUsernamePasswordPort])
|
|
return;
|
|
const ctx = this[context];
|
|
if (port === '') {
|
|
ctx.port = null;
|
|
return;
|
|
}
|
|
parse(port, kPort, null, ctx, onParsePortComplete.bind(this));
|
|
}
|
|
},
|
|
pathname: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
const ctx = this[context];
|
|
if (this[cannotBeBase])
|
|
return ctx.path[0];
|
|
if (ctx.path.length === 0)
|
|
return '';
|
|
return `/${ctx.path.join('/')}`;
|
|
},
|
|
set(path) {
|
|
// toUSVString is not needed.
|
|
path = `${path}`;
|
|
if (this[cannotBeBase])
|
|
return;
|
|
parse(path, kPathStart, null, this[context],
|
|
onParsePathComplete.bind(this));
|
|
}
|
|
},
|
|
search: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
const { query } = this[context];
|
|
if (query === null || query === '')
|
|
return '';
|
|
return `?${query}`;
|
|
},
|
|
set(search) {
|
|
const ctx = this[context];
|
|
search = toUSVString(search);
|
|
if (search === '') {
|
|
ctx.query = null;
|
|
ctx.flags &= ~URL_FLAGS_HAS_QUERY;
|
|
} else {
|
|
if (search[0] === '?') search = search.slice(1);
|
|
ctx.query = '';
|
|
ctx.flags |= URL_FLAGS_HAS_QUERY;
|
|
if (search) {
|
|
parse(search, kQuery, null, ctx, onParseSearchComplete.bind(this));
|
|
}
|
|
}
|
|
initSearchParams(this[searchParams], search);
|
|
}
|
|
},
|
|
searchParams: { // readonly
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
return this[searchParams];
|
|
}
|
|
},
|
|
hash: {
|
|
enumerable: true,
|
|
configurable: true,
|
|
get() {
|
|
const { fragment } = this[context];
|
|
if (fragment === null || fragment === '')
|
|
return '';
|
|
return `#${fragment}`;
|
|
},
|
|
set(hash) {
|
|
const ctx = this[context];
|
|
// toUSVString is not needed.
|
|
hash = `${hash}`;
|
|
if (!hash) {
|
|
ctx.fragment = null;
|
|
ctx.flags &= ~URL_FLAGS_HAS_FRAGMENT;
|
|
return;
|
|
}
|
|
if (hash[0] === '#') hash = hash.slice(1);
|
|
ctx.fragment = '';
|
|
ctx.flags |= URL_FLAGS_HAS_FRAGMENT;
|
|
parse(hash, kFragment, null, ctx, onParseHashComplete.bind(this));
|
|
}
|
|
},
|
|
toJSON: {
|
|
writable: true,
|
|
enumerable: true,
|
|
configurable: true,
|
|
// eslint-disable-next-line func-name-matching
|
|
value: function toJSON() {
|
|
return this[kFormat]({});
|
|
}
|
|
}
|
|
});
|
|
|
|
function update(url, params) {
|
|
if (!url)
|
|
return;
|
|
|
|
const ctx = url[context];
|
|
const serializedParams = params.toString();
|
|
if (serializedParams) {
|
|
ctx.query = serializedParams;
|
|
ctx.flags |= URL_FLAGS_HAS_QUERY;
|
|
} else {
|
|
ctx.query = null;
|
|
ctx.flags &= ~URL_FLAGS_HAS_QUERY;
|
|
}
|
|
}
|
|
|
|
function initSearchParams(url, init) {
|
|
if (!init) {
|
|
url[searchParams] = [];
|
|
return;
|
|
}
|
|
url[searchParams] = parseParams(init);
|
|
}
|
|
|
|
// application/x-www-form-urlencoded parser
|
|
// Ref: https://url.spec.whatwg.org/#concept-urlencoded-parser
|
|
function parseParams(qs) {
|
|
const out = [];
|
|
var pairStart = 0;
|
|
var lastPos = 0;
|
|
var seenSep = false;
|
|
var buf = '';
|
|
var encoded = false;
|
|
var encodeCheck = 0;
|
|
var i;
|
|
for (i = 0; i < qs.length; ++i) {
|
|
const code = qs.charCodeAt(i);
|
|
|
|
// Try matching key/value pair separator
|
|
if (code === CHAR_AMPERSAND) {
|
|
if (pairStart === i) {
|
|
// We saw an empty substring between pair separators
|
|
lastPos = pairStart = i + 1;
|
|
continue;
|
|
}
|
|
|
|
if (lastPos < i)
|
|
buf += qs.slice(lastPos, i);
|
|
if (encoded)
|
|
buf = querystring.unescape(buf);
|
|
out.push(buf);
|
|
|
|
// If `buf` is the key, add an empty value.
|
|
if (!seenSep)
|
|
out.push('');
|
|
|
|
seenSep = false;
|
|
buf = '';
|
|
encoded = false;
|
|
encodeCheck = 0;
|
|
lastPos = pairStart = i + 1;
|
|
continue;
|
|
}
|
|
|
|
// Try matching key/value separator (e.g. '=') if we haven't already
|
|
if (!seenSep && code === CHAR_EQUAL) {
|
|
// Key/value separator match!
|
|
if (lastPos < i)
|
|
buf += qs.slice(lastPos, i);
|
|
if (encoded)
|
|
buf = querystring.unescape(buf);
|
|
out.push(buf);
|
|
|
|
seenSep = true;
|
|
buf = '';
|
|
encoded = false;
|
|
encodeCheck = 0;
|
|
lastPos = i + 1;
|
|
continue;
|
|
}
|
|
|
|
// Handle + and percent decoding.
|
|
if (code === CHAR_PLUS) {
|
|
if (lastPos < i)
|
|
buf += qs.slice(lastPos, i);
|
|
buf += ' ';
|
|
lastPos = i + 1;
|
|
} else if (!encoded) {
|
|
// Try to match an (valid) encoded byte (once) to minimize unnecessary
|
|
// calls to string decoding functions
|
|
if (code === CHAR_PERCENT) {
|
|
encodeCheck = 1;
|
|
} else if (encodeCheck > 0) {
|
|
if (isHexTable[code] === 1) {
|
|
if (++encodeCheck === 3) {
|
|
querystring = require('querystring');
|
|
encoded = true;
|
|
}
|
|
} else {
|
|
encodeCheck = 0;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Deal with any leftover key or value data
|
|
|
|
// There is a trailing &. No more processing is needed.
|
|
if (pairStart === i)
|
|
return out;
|
|
|
|
if (lastPos < i)
|
|
buf += qs.slice(lastPos, i);
|
|
if (encoded)
|
|
buf = querystring.unescape(buf);
|
|
out.push(buf);
|
|
|
|
// If `buf` is the key, add an empty value.
|
|
if (!seenSep)
|
|
out.push('');
|
|
|
|
return out;
|
|
}
|
|
|
|
// Adapted from querystring's implementation.
|
|
// Ref: https://url.spec.whatwg.org/#concept-urlencoded-byte-serializer
|
|
const noEscape = [
|
|
/*
|
|
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F
|
|
*/
|
|
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0x00 - 0x0F
|
|
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 0x10 - 0x1F
|
|
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 1, 0, // 0x20 - 0x2F
|
|
1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, // 0x30 - 0x3F
|
|
0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x40 - 0x4F
|
|
1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 1, // 0x50 - 0x5F
|
|
0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, // 0x60 - 0x6F
|
|
1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0 // 0x70 - 0x7F
|
|
];
|
|
|
|
// Special version of hexTable that uses `+` for U+0020 SPACE.
|
|
const paramHexTable = hexTable.slice();
|
|
paramHexTable[0x20] = '+';
|
|
|
|
// application/x-www-form-urlencoded serializer
|
|
// Ref: https://url.spec.whatwg.org/#concept-urlencoded-serializer
|
|
function serializeParams(array) {
|
|
const len = array.length;
|
|
if (len === 0)
|
|
return '';
|
|
|
|
const firstEncodedParam = encodeStr(array[0], noEscape, paramHexTable);
|
|
const firstEncodedValue = encodeStr(array[1], noEscape, paramHexTable);
|
|
let output = `${firstEncodedParam}=${firstEncodedValue}`;
|
|
|
|
for (var i = 2; i < len; i += 2) {
|
|
const encodedParam = encodeStr(array[i], noEscape, paramHexTable);
|
|
const encodedValue = encodeStr(array[i + 1], noEscape, paramHexTable);
|
|
output += `&${encodedParam}=${encodedValue}`;
|
|
}
|
|
|
|
return output;
|
|
}
|
|
|
|
// Mainly to mitigate func-name-matching ESLint rule
|
|
function defineIDLClass(proto, classStr, obj) {
|
|
// https://heycam.github.io/webidl/#dfn-class-string
|
|
Object.defineProperty(proto, Symbol.toStringTag, {
|
|
writable: false,
|
|
enumerable: false,
|
|
configurable: true,
|
|
value: classStr
|
|
});
|
|
|
|
// https://heycam.github.io/webidl/#es-operations
|
|
for (const key of Object.keys(obj)) {
|
|
Object.defineProperty(proto, key, {
|
|
writable: true,
|
|
enumerable: true,
|
|
configurable: true,
|
|
value: obj[key]
|
|
});
|
|
}
|
|
for (const key of Object.getOwnPropertySymbols(obj)) {
|
|
Object.defineProperty(proto, key, {
|
|
writable: true,
|
|
enumerable: false,
|
|
configurable: true,
|
|
value: obj[key]
|
|
});
|
|
}
|
|
}
|
|
|
|
// for merge sort
|
|
function merge(out, start, mid, end, lBuffer, rBuffer) {
|
|
const sizeLeft = mid - start;
|
|
const sizeRight = end - mid;
|
|
var l, r, o;
|
|
|
|
for (l = 0; l < sizeLeft; l++)
|
|
lBuffer[l] = out[start + l];
|
|
for (r = 0; r < sizeRight; r++)
|
|
rBuffer[r] = out[mid + r];
|
|
|
|
l = 0;
|
|
r = 0;
|
|
o = start;
|
|
while (l < sizeLeft && r < sizeRight) {
|
|
if (lBuffer[l] <= rBuffer[r]) {
|
|
out[o++] = lBuffer[l++];
|
|
out[o++] = lBuffer[l++];
|
|
} else {
|
|
out[o++] = rBuffer[r++];
|
|
out[o++] = rBuffer[r++];
|
|
}
|
|
}
|
|
while (l < sizeLeft)
|
|
out[o++] = lBuffer[l++];
|
|
while (r < sizeRight)
|
|
out[o++] = rBuffer[r++];
|
|
}
|
|
|
|
defineIDLClass(URLSearchParams.prototype, 'URLSearchParams', {
|
|
append(name, value) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (arguments.length < 2) {
|
|
throw new ERR_MISSING_ARGS('name', 'value');
|
|
}
|
|
|
|
name = toUSVString(name);
|
|
value = toUSVString(value);
|
|
this[searchParams].push(name, value);
|
|
update(this[context], this);
|
|
},
|
|
|
|
delete(name) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (arguments.length < 1) {
|
|
throw new ERR_MISSING_ARGS('name');
|
|
}
|
|
|
|
const list = this[searchParams];
|
|
name = toUSVString(name);
|
|
for (var i = 0; i < list.length;) {
|
|
const cur = list[i];
|
|
if (cur === name) {
|
|
list.splice(i, 2);
|
|
} else {
|
|
i += 2;
|
|
}
|
|
}
|
|
update(this[context], this);
|
|
},
|
|
|
|
get(name) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (arguments.length < 1) {
|
|
throw new ERR_MISSING_ARGS('name');
|
|
}
|
|
|
|
const list = this[searchParams];
|
|
name = toUSVString(name);
|
|
for (var i = 0; i < list.length; i += 2) {
|
|
if (list[i] === name) {
|
|
return list[i + 1];
|
|
}
|
|
}
|
|
return null;
|
|
},
|
|
|
|
getAll(name) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (arguments.length < 1) {
|
|
throw new ERR_MISSING_ARGS('name');
|
|
}
|
|
|
|
const list = this[searchParams];
|
|
const values = [];
|
|
name = toUSVString(name);
|
|
for (var i = 0; i < list.length; i += 2) {
|
|
if (list[i] === name) {
|
|
values.push(list[i + 1]);
|
|
}
|
|
}
|
|
return values;
|
|
},
|
|
|
|
has(name) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (arguments.length < 1) {
|
|
throw new ERR_MISSING_ARGS('name');
|
|
}
|
|
|
|
const list = this[searchParams];
|
|
name = toUSVString(name);
|
|
for (var i = 0; i < list.length; i += 2) {
|
|
if (list[i] === name) {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
},
|
|
|
|
set(name, value) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (arguments.length < 2) {
|
|
throw new ERR_MISSING_ARGS('name', 'value');
|
|
}
|
|
|
|
const list = this[searchParams];
|
|
name = toUSVString(name);
|
|
value = toUSVString(value);
|
|
|
|
// If there are any name-value pairs whose name is `name`, in `list`, set
|
|
// the value of the first such name-value pair to `value` and remove the
|
|
// others.
|
|
var found = false;
|
|
for (var i = 0; i < list.length;) {
|
|
const cur = list[i];
|
|
if (cur === name) {
|
|
if (!found) {
|
|
list[i + 1] = value;
|
|
found = true;
|
|
i += 2;
|
|
} else {
|
|
list.splice(i, 2);
|
|
}
|
|
} else {
|
|
i += 2;
|
|
}
|
|
}
|
|
|
|
// Otherwise, append a new name-value pair whose name is `name` and value
|
|
// is `value`, to `list`.
|
|
if (!found) {
|
|
list.push(name, value);
|
|
}
|
|
|
|
update(this[context], this);
|
|
},
|
|
|
|
sort() {
|
|
const a = this[searchParams];
|
|
const len = a.length;
|
|
|
|
if (len <= 2) {
|
|
// Nothing needs to be done.
|
|
} else if (len < 100) {
|
|
// 100 is found through testing.
|
|
// Simple stable in-place insertion sort
|
|
// Derived from v8/src/js/array.js
|
|
for (var i = 2; i < len; i += 2) {
|
|
var curKey = a[i];
|
|
var curVal = a[i + 1];
|
|
var j;
|
|
for (j = i - 2; j >= 0; j -= 2) {
|
|
if (a[j] > curKey) {
|
|
a[j + 2] = a[j];
|
|
a[j + 3] = a[j + 1];
|
|
} else {
|
|
break;
|
|
}
|
|
}
|
|
a[j + 2] = curKey;
|
|
a[j + 3] = curVal;
|
|
}
|
|
} else {
|
|
// Bottom-up iterative stable merge sort
|
|
const lBuffer = new Array(len);
|
|
const rBuffer = new Array(len);
|
|
for (var step = 2; step < len; step *= 2) {
|
|
for (var start = 0; start < len - 2; start += 2 * step) {
|
|
var mid = start + step;
|
|
var end = mid + step;
|
|
end = end < len ? end : len;
|
|
if (mid > end)
|
|
continue;
|
|
merge(a, start, mid, end, lBuffer, rBuffer);
|
|
}
|
|
}
|
|
}
|
|
|
|
update(this[context], this);
|
|
},
|
|
|
|
// https://heycam.github.io/webidl/#es-iterators
|
|
// Define entries here rather than [Symbol.iterator] as the function name
|
|
// must be set to `entries`.
|
|
entries() {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
|
|
return createSearchParamsIterator(this, 'key+value');
|
|
},
|
|
|
|
forEach(callback, thisArg = undefined) {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
if (typeof callback !== 'function') {
|
|
throw new ERR_INVALID_CALLBACK();
|
|
}
|
|
|
|
let list = this[searchParams];
|
|
|
|
var i = 0;
|
|
while (i < list.length) {
|
|
const key = list[i];
|
|
const value = list[i + 1];
|
|
callback.call(thisArg, value, key, this);
|
|
// In case the URL object's `search` is updated
|
|
list = this[searchParams];
|
|
i += 2;
|
|
}
|
|
},
|
|
|
|
// https://heycam.github.io/webidl/#es-iterable
|
|
keys() {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
|
|
return createSearchParamsIterator(this, 'key');
|
|
},
|
|
|
|
values() {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
|
|
return createSearchParamsIterator(this, 'value');
|
|
},
|
|
|
|
// https://heycam.github.io/webidl/#es-stringifier
|
|
// https://url.spec.whatwg.org/#urlsearchparams-stringification-behavior
|
|
toString() {
|
|
if (!this || !this[searchParams] || this[searchParams][searchParams]) {
|
|
throw new ERR_INVALID_THIS('URLSearchParams');
|
|
}
|
|
|
|
return serializeParams(this[searchParams]);
|
|
}
|
|
});
|
|
|
|
// https://heycam.github.io/webidl/#es-iterable-entries
|
|
Object.defineProperty(URLSearchParams.prototype, Symbol.iterator, {
|
|
writable: true,
|
|
configurable: true,
|
|
value: URLSearchParams.prototype.entries
|
|
});
|
|
|
|
// https://heycam.github.io/webidl/#dfn-default-iterator-object
|
|
function createSearchParamsIterator(target, kind) {
|
|
const iterator = Object.create(URLSearchParamsIteratorPrototype);
|
|
iterator[context] = {
|
|
target,
|
|
kind,
|
|
index: 0
|
|
};
|
|
return iterator;
|
|
}
|
|
|
|
// https://heycam.github.io/webidl/#dfn-iterator-prototype-object
|
|
const URLSearchParamsIteratorPrototype = Object.create(IteratorPrototype);
|
|
|
|
defineIDLClass(URLSearchParamsIteratorPrototype, 'URLSearchParams Iterator', {
|
|
next() {
|
|
if (!this ||
|
|
Object.getPrototypeOf(this) !== URLSearchParamsIteratorPrototype) {
|
|
throw new ERR_INVALID_THIS('URLSearchParamsIterator');
|
|
}
|
|
|
|
const {
|
|
target,
|
|
kind,
|
|
index
|
|
} = this[context];
|
|
const values = target[searchParams];
|
|
const len = values.length;
|
|
if (index >= len) {
|
|
return {
|
|
value: undefined,
|
|
done: true
|
|
};
|
|
}
|
|
|
|
const name = values[index];
|
|
const value = values[index + 1];
|
|
this[context].index = index + 2;
|
|
|
|
let result;
|
|
if (kind === 'key') {
|
|
result = name;
|
|
} else if (kind === 'value') {
|
|
result = value;
|
|
} else {
|
|
result = [name, value];
|
|
}
|
|
|
|
return {
|
|
value: result,
|
|
done: false
|
|
};
|
|
},
|
|
[util.inspect.custom](recurseTimes, ctx) {
|
|
if (this == null || this[context] == null || this[context].target == null)
|
|
throw new ERR_INVALID_THIS('URLSearchParamsIterator');
|
|
|
|
if (typeof recurseTimes === 'number' && recurseTimes < 0)
|
|
return ctx.stylize('[Object]', 'special');
|
|
|
|
const innerOpts = { ...ctx };
|
|
if (recurseTimes !== null) {
|
|
innerOpts.depth = recurseTimes - 1;
|
|
}
|
|
const {
|
|
target,
|
|
kind,
|
|
index
|
|
} = this[context];
|
|
const output = target[searchParams].slice(index).reduce((prev, cur, i) => {
|
|
const key = i % 2 === 0;
|
|
if (kind === 'key' && key) {
|
|
prev.push(cur);
|
|
} else if (kind === 'value' && !key) {
|
|
prev.push(cur);
|
|
} else if (kind === 'key+value' && !key) {
|
|
prev.push([target[searchParams][index + i - 1], cur]);
|
|
}
|
|
return prev;
|
|
}, []);
|
|
const breakLn = util.inspect(output, innerOpts).includes('\n');
|
|
const outputStrs = output.map((p) => util.inspect(p, innerOpts));
|
|
let outputStr;
|
|
if (breakLn) {
|
|
outputStr = `\n ${outputStrs.join(',\n ')}`;
|
|
} else {
|
|
outputStr = ` ${outputStrs.join(', ')}`;
|
|
}
|
|
return `${this[Symbol.toStringTag]} {${outputStr} }`;
|
|
}
|
|
});
|
|
|
|
function domainToASCII(domain) {
|
|
if (arguments.length < 1)
|
|
throw new ERR_MISSING_ARGS('domain');
|
|
|
|
// toUSVString is not needed.
|
|
return _domainToASCII(`${domain}`);
|
|
}
|
|
|
|
function domainToUnicode(domain) {
|
|
if (arguments.length < 1)
|
|
throw new ERR_MISSING_ARGS('domain');
|
|
|
|
// toUSVString is not needed.
|
|
return _domainToUnicode(`${domain}`);
|
|
}
|
|
|
|
// Utility function that converts a URL object into an ordinary
|
|
// options object as expected by the http.request and https.request
|
|
// APIs.
|
|
function urlToOptions(url) {
|
|
var options = {
|
|
protocol: url.protocol,
|
|
hostname: typeof url.hostname === 'string' && url.hostname.startsWith('[') ?
|
|
url.hostname.slice(1, -1) :
|
|
url.hostname,
|
|
hash: url.hash,
|
|
search: url.search,
|
|
pathname: url.pathname,
|
|
path: `${url.pathname || ''}${url.search || ''}`,
|
|
href: url.href
|
|
};
|
|
if (url.port !== '') {
|
|
options.port = Number(url.port);
|
|
}
|
|
if (url.username || url.password) {
|
|
options.auth = `${url.username}:${url.password}`;
|
|
}
|
|
return options;
|
|
}
|
|
|
|
const forwardSlashRegEx = /\//g;
|
|
|
|
function getPathFromURLWin32(url) {
|
|
var hostname = url.hostname;
|
|
var pathname = url.pathname;
|
|
for (var n = 0; n < pathname.length; n++) {
|
|
if (pathname[n] === '%') {
|
|
var third = pathname.codePointAt(n + 2) | 0x20;
|
|
if ((pathname[n + 1] === '2' && third === 102) || // 2f 2F /
|
|
(pathname[n + 1] === '5' && third === 99)) { // 5c 5C \
|
|
throw new ERR_INVALID_FILE_URL_PATH(
|
|
'must not include encoded \\ or / characters'
|
|
);
|
|
}
|
|
}
|
|
}
|
|
pathname = pathname.replace(forwardSlashRegEx, '\\');
|
|
pathname = decodeURIComponent(pathname);
|
|
if (hostname !== '') {
|
|
// If hostname is set, then we have a UNC path
|
|
// Pass the hostname through domainToUnicode just in case
|
|
// it is an IDN using punycode encoding. We do not need to worry
|
|
// about percent encoding because the URL parser will have
|
|
// already taken care of that for us. Note that this only
|
|
// causes IDNs with an appropriate `xn--` prefix to be decoded.
|
|
return `\\\\${domainToUnicode(hostname)}${pathname}`;
|
|
} else {
|
|
// Otherwise, it's a local path that requires a drive letter
|
|
var letter = pathname.codePointAt(1) | 0x20;
|
|
var sep = pathname[2];
|
|
if (letter < CHAR_LOWERCASE_A || letter > CHAR_LOWERCASE_Z || // a..z A..Z
|
|
(sep !== ':')) {
|
|
throw new ERR_INVALID_FILE_URL_PATH('must be absolute');
|
|
}
|
|
return pathname.slice(1);
|
|
}
|
|
}
|
|
|
|
function getPathFromURLPosix(url) {
|
|
if (url.hostname !== '') {
|
|
throw new ERR_INVALID_FILE_URL_HOST(platform);
|
|
}
|
|
var pathname = url.pathname;
|
|
for (var n = 0; n < pathname.length; n++) {
|
|
if (pathname[n] === '%') {
|
|
var third = pathname.codePointAt(n + 2) | 0x20;
|
|
if (pathname[n + 1] === '2' && third === 102) {
|
|
throw new ERR_INVALID_FILE_URL_PATH(
|
|
'must not include encoded / characters'
|
|
);
|
|
}
|
|
}
|
|
}
|
|
return decodeURIComponent(pathname);
|
|
}
|
|
|
|
function fileURLToPath(path) {
|
|
if (typeof path === 'string')
|
|
path = new URL(path);
|
|
else if (path == null || !path[searchParams] ||
|
|
!path[searchParams][searchParams])
|
|
throw new ERR_INVALID_ARG_TYPE('path', ['string', 'URL'], path);
|
|
if (path.protocol !== 'file:')
|
|
throw new ERR_INVALID_URL_SCHEME('file');
|
|
return isWindows ? getPathFromURLWin32(path) : getPathFromURLPosix(path);
|
|
}
|
|
|
|
// The following characters are percent-encoded when converting from file path
|
|
// to URL:
|
|
// - %: The percent character is the only character not encoded by the
|
|
// `pathname` setter.
|
|
// - \: Backslash is encoded on non-windows platforms since it's a valid
|
|
// character but the `pathname` setters replaces it by a forward slash.
|
|
// - LF: The newline character is stripped out by the `pathname` setter.
|
|
// (See whatwg/url#419)
|
|
// - CR: The carriage return character is also stripped out by the `pathname`
|
|
// setter.
|
|
// - TAB: The tab character is also stripped out by the `pathname` setter.
|
|
const percentRegEx = /%/g;
|
|
const backslashRegEx = /\\/g;
|
|
const newlineRegEx = /\n/g;
|
|
const carriageReturnRegEx = /\r/g;
|
|
const tabRegEx = /\t/g;
|
|
function pathToFileURL(filepath) {
|
|
let resolved = path.resolve(filepath);
|
|
// path.resolve strips trailing slashes so we must add them back
|
|
const filePathLast = filepath.charCodeAt(filepath.length - 1);
|
|
if ((filePathLast === CHAR_FORWARD_SLASH ||
|
|
isWindows && filePathLast === CHAR_BACKWARD_SLASH) &&
|
|
resolved[resolved.length - 1] !== path.sep)
|
|
resolved += '/';
|
|
const outURL = new URL('file://');
|
|
if (resolved.includes('%'))
|
|
resolved = resolved.replace(percentRegEx, '%25');
|
|
// In posix, "/" is a valid character in paths
|
|
if (!isWindows && resolved.includes('\\'))
|
|
resolved = resolved.replace(backslashRegEx, '%5C');
|
|
if (resolved.includes('\n'))
|
|
resolved = resolved.replace(newlineRegEx, '%0A');
|
|
if (resolved.includes('\r'))
|
|
resolved = resolved.replace(carriageReturnRegEx, '%0D');
|
|
if (resolved.includes('\t'))
|
|
resolved = resolved.replace(tabRegEx, '%09');
|
|
outURL.pathname = resolved;
|
|
return outURL;
|
|
}
|
|
|
|
function toPathIfFileURL(fileURLOrPath) {
|
|
if (fileURLOrPath == null || !fileURLOrPath[searchParams] ||
|
|
!fileURLOrPath[searchParams][searchParams])
|
|
return fileURLOrPath;
|
|
return fileURLToPath(fileURLOrPath);
|
|
}
|
|
|
|
function constructUrl(flags, protocol, username, password,
|
|
host, port, path, query, fragment) {
|
|
var ctx = new URLContext();
|
|
ctx.flags = flags;
|
|
ctx.scheme = protocol;
|
|
ctx.username = (flags & URL_FLAGS_HAS_USERNAME) !== 0 ? username : '';
|
|
ctx.password = (flags & URL_FLAGS_HAS_PASSWORD) !== 0 ? password : '';
|
|
ctx.port = port;
|
|
ctx.path = (flags & URL_FLAGS_HAS_PATH) !== 0 ? path : [];
|
|
ctx.query = query;
|
|
ctx.fragment = fragment;
|
|
ctx.host = host;
|
|
|
|
const url = Object.create(URL.prototype);
|
|
url[context] = ctx;
|
|
const params = new URLSearchParams();
|
|
url[searchParams] = params;
|
|
params[context] = url;
|
|
initSearchParams(params, query);
|
|
return url;
|
|
}
|
|
setURLConstructor(constructUrl);
|
|
|
|
module.exports = {
|
|
toUSVString,
|
|
fileURLToPath,
|
|
pathToFileURL,
|
|
toPathIfFileURL,
|
|
URL,
|
|
URLSearchParams,
|
|
domainToASCII,
|
|
domainToUnicode,
|
|
urlToOptions,
|
|
formatSymbol: kFormat,
|
|
searchParamsSymbol: searchParams,
|
|
encodeStr
|
|
};
|