node:url

توفر ⁦node:url⁩ مساعدات ⁦URL⁩ القديمة في ⁦Node⁩ إلى جانب المُنشئين العامين ⁦URL⁩ و ⁦URLSearchParams⁩.

const url = require("node:url");
const parsed = url.parse("https://user:pw@example.com:8080/a?x=1#h", true);
parsed.host;    // "example.com:8080"
parsed.query.x; // "1"

url.resolve("https://example.com/a/b/c", "../x");
// "https://example.com/a/x"

المساعد	النتيجة
`parse(value, parseQueryString?, slashesDenoteHost?)`	كائن ⁦`UrlObject`⁩ قديم؛ وتصبح المفاتيح المكررة المحلَّلة مصفوفات.
`format(value)`	سلسلة مبنية من كائن قديم أو من ⁦`URL`⁩ وفق ⁦WHATWG⁩.
`resolve(from, to)`	سلسلة ⁦URL⁩ محلولة.
`resolveObject(from, to)`	كائن قديم محلول.
`domainToASCII()` / `domainToUnicode()`	تحويل ⁦IDN⁩.
`fileURLToPath()` / `pathToFileURL()`	التحويل بين عنوان ⁦URL⁩ لملف والمسار المطلق.
`urlToHttpOptions()`	خيارات لواجهات طلبات ⁦HTTP⁩ في ⁦Node⁩.

‏⁦url.URL === globalThis.URL⁩ و ⁦url.URLSearchParams === globalThis.URLSearchParams⁩. وينبغي للشيفرة الجديدة تفضيل مُنشئات ⁦WHATWG⁩ هذه على المحلّل القديم.

انظر أيضًا

Reference

Status: Full · 40 of 42 suite tests pass (95.2%) · since 1.1.0

Exports

Export	Kind	Status	Notes
`parse()`	function	Full	Parses a URL string into a UrlObject (legacy API)
`format()`	function	Full	Formats a URL object or WHATWG URL back into a string
`resolve()`	function	Full	Resolves a target URL relative to a base URL (legacy API)
`URL`	property	Full	The WHATWG URL class (same as global URL)
`URLSearchParams`	property	Full	The WHATWG URLSearchParams class (same as global URLSearchParams)
`domainToASCII()`	function	Full	Converts a Unicode domain name to its ASCII (Punycode) representation
`domainToUnicode()`	function	Full	Converts an ASCII (Punycode) domain name to Unicode
`fileURLToPath()`	function	Full	Converts a file: URL to a filesystem path string
`pathToFileURL()`	function	Full	Converts an absolute filesystem path to a file: URL
`urlToHttpOptions()`	function	Full	Returns an object with URL components suitable for use with http.request()
`resolveObject()`	function	Full	Resolves a relative URL against a source URL object, similar to a browser resolving an anchor tag

Tests: node-api node:url: 40 pass, 2 fail, 0 error, 3 skipped. Failing: test-whatwg-url-custom-inspect.js, test-whatwg-url-custom-parsing.js.