encodeUrl

Codifica una URL sin peligro: deja intactas las secuencias ya codificadas y trata los pares suplentes sueltos.

API

encodeUrl

Devuelve

Argumento	Descripción	Tipo
string	La URL codificada	string

Parámetros

Parámetro	Descripción	Tipo	Por defecto
url	URL que se codifica	string	Obligatorio

Ejemplo

Uso básico

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'

URL ya codificadas

import { encodeUrl } from 'ranuts';

// Lo que ya estaba codificado no se vuelve a codificar
const url = 'https://example.com/path%20with%20spaces';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%20with%20spaces'

Caracteres especiales

import { encodeUrl } from 'ranuts';

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

Codificaciones rotas

import { encodeUrl } from 'ranuts';

// Las secuencias rotas (como %foo) sí se codifican
const url = 'https://example.com/path%foo';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%25foo'

Notas

1. Codificación con criterio: solo toca lo que no estaba codificado; las secuencias ya codificadas (como %20) se quedan como están.
2. Pares suplentes: los pares suplentes sueltos se resuelven solos y se sustituyen por el carácter de reemplazo de Unicode.
3. Sin errores: no lanza excepciones; intenta codificar la URL lo mejor posible.
4. Cuándo usarlo: es habitual para tratar URL escritas por el usuario y para construir URL seguras.