decodeURI()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Funktion decodeURI() dekodiert einen zuvor durch encodeURI() oder eine ähnliche Routine erstellten Uniform Resource Identifier (URI).

Probieren Sie es aus

Syntax

js
decodeURI(encodedURI)

Parameter

encodedURI

Ein vollständiger, kodierter Uniform Resource Identifier.

Rückgabewert

Ein neuer String, der die dekodierte Version des angegebenen kodierten Uniform Resource Identifier (URI) darstellt.

Ausnahmen

URIError

Wird ausgelöst, wenn encodedURI ein % enthält, dem nicht zwei hexadezimale Ziffern folgen, oder wenn die Escape-Sequenz kein gültiges UTF-8-Zeichen kodiert.

Beschreibung

decodeURI() ist eine Funktions-Eigenschaft des globalen Objekts.

Die Funktion decodeURI() dekodiert den URI, indem sie jede Escape-Sequenz in der Form %XX als eine UTF-8-Codeeinheit (ein Byte) behandelt. In UTF-8 gibt die Anzahl der führenden 1-Bits im ersten Byte, die 0 (für 1-Byte-ASCII-Zeichen), 2, 3 oder 4 sein kann, die Anzahl der Bytes im Zeichen an. Durch das Lesen der ersten Escape-Sequenz kann decodeURI() feststellen, wie viele weitere Escape-Sequenzen konsumiert werden müssen. Wenn decodeURI() die erwartete Anzahl von Sequenzen nicht findet, oder wenn die Escape-Sequenzen kein gültiges UTF-8-Zeichen kodieren, wird ein URIError ausgelöst.

decodeURI() dekodiert alle Escape-Sequenzen, aber wenn die Escape-Sequenz eines der folgenden Zeichen kodiert, bleibt die Escape-Sequenz im Ergebnisstring erhalten (weil sie Teil der URI-Syntax sind):

; / ? : @ & = + $ , #

Beispiele

Dekodierung einer kyrillischen URL

js
decodeURI(
  "https://developer.mozilla.org/ru/docs/JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B",
);
// "https://developer.mozilla.org/ru/docs/JavaScript_шеллы"

decodeURI() vs. decodeURIComponent()

decodeURI() geht davon aus, dass der Eingabewert ein vollständiger URI ist, daher dekodiert es keine Zeichen, die Teil der URI-Syntax sind.

js
decodeURI(
  "https://developer.mozilla.org/docs/JavaScript%3A%20a_scripting_language",
);
// "https://developer.mozilla.org/docs/JavaScript%3A a_scripting_language"

decodeURIComponent(
  "https://developer.mozilla.org/docs/JavaScript%3A%20a_scripting_language",
);
// "https://developer.mozilla.org/docs/JavaScript: a_scripting_language"

Fehler abfangen

js
try {
  const a = decodeURI("%E0%A4%A");
} catch (e) {
  console.error(e);
}

// URIError: malformed URI sequence

Spezifikationen

Specification
ECMAScript Language Specification
# sec-decodeuri-encodeduri

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch