ran
Deutsch

encodeUrl

Kodiert eine URL gefahrlos: bereits kodierte Folgen bleiben unangetastet, unpaarige Ersatzzeichen werden behandelt.

API

encodeUrl

Rückgabe

Argument Beschreibung Typ
string Die kodierte URL string

Parameter

Parameter Beschreibung Typ Standard
url Zu kodierende URL string Erforderlich

Beispiel

Grundlegende Verwendung

import { encodeUrl } from 'ranuts';

const url = 'https://example.com/path with spaces';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%20with%20spaces'

Bereits kodierte URLs

import { encodeUrl } from 'ranuts';

// Was schon kodiert war, wird nicht erneut kodiert
const url = 'https://example.com/path%20with%20spaces';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%20with%20spaces'

Sonderzeichen

import { encodeUrl } from 'ranuts';

const url = 'https://example.com/search?q=hello world&lang=zh-CN';
const encoded = encodeUrl(url);
console.log(encoded); // Die kodierte URL

Kaputte Kodierungen

import { encodeUrl } from 'ranuts';

// Kaputte Folgen (etwa %foo) werden sehr wohl kodiert
const url = 'https://example.com/path%foo';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%25foo'

Hinweise

  1. Kodiert mit Augenmaß: Angefasst wird nur, was noch nicht kodiert war; bereits kodierte Folgen wie %20 bleiben, wie sie sind.
  2. Ersatzzeichen: Unpaarige Ersatzzeichen werden von allein behandelt und durch das Unicode-Ersatzzeichen ersetzt.
  3. Keine Fehler: Es wird nichts geworfen; die URL wird so gut wie möglich kodiert.
  4. Einsatz: üblich für URLs aus Benutzereingaben und für das Zusammensetzen sicherer URLs.