Zum Inhalt springen

node:url

Veraltete URL-Hilfsfunktionen von Node.js und Re-Exporte der WHATWG-URL

Auf dieser Seite
Open in ChatGPTOpen in Claude

node:url liefert die veralteten URL-Hilfsfunktionen von Node neben den globalen Konstruktoren URL und 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"
HilfsfunktionErgebnis
parse(value, parseQueryString?, slashesDenoteHost?)Ein veraltetes UrlObject; doppelte geparste Schlüssel werden zu Arrays.
format(value)Eine Zeichenkette, gebildet aus einem veralteten Objekt oder einer WHATWG-URL.
resolve(from, to)Eine aufgelöste URL-Zeichenkette.
resolveObject(from, to)Ein aufgelöstes veraltetes Objekt.
domainToASCII() / domainToUnicode()IDN-Konvertierung.
fileURLToPath() / pathToFileURL()Konvertierung zwischen Datei-URL und absolutem Pfad.
urlToHttpOptions()Optionen für die HTTP-Anfrage-APIs von Node.

url.URL === globalThis.URL und url.URLSearchParams === globalThis.URLSearchParams. Neuer Code sollte diese WHATWG-Konstruktoren dem veralteten Parser vorziehen.

Siehe auch

Reference

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

Exports

ExportKindStatusNotes
parse()functionFullParses a URL string into a UrlObject (legacy API)
format()functionFullFormats a URL object or WHATWG URL back into a string
resolve()functionFullResolves a target URL relative to a base URL (legacy API)
URLpropertyFullThe WHATWG URL class (same as global URL)
URLSearchParamspropertyFullThe WHATWG URLSearchParams class (same as global URLSearchParams)
domainToASCII()functionFullConverts a Unicode domain name to its ASCII (Punycode) representation
domainToUnicode()functionFullConverts an ASCII (Punycode) domain name to Unicode
fileURLToPath()functionFullConverts a file: URL to a filesystem path string
pathToFileURL()functionFullConverts an absolute filesystem path to a file: URL
urlToHttpOptions()functionFullReturns an object with URL components suitable for use with http.request()
resolveObject()functionFullResolves 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.

War diese Seite hilfreich?