Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

URL.hash y URL.href: fragmento y URL completa

Usa `hash` para leer o modificar el fragmento y `href` para leer o sustituir toda la URL. Leer solo `hash` no permite distinguir entre un fragmento vacío y uno ausente.

Versión: Current web platform; runtime support varies

Sintaxis

const url = new URL(input, base); // Omit base for an absolute input.
url.hash;                        // Fragment string
url.hash = fragment;
url.href;                        // Full serialized URL
url.href = absoluteUrl;

hash y href son propiedades de instancia de URL, no métodos ni propiedades estáticas. url.hash devuelve el fragmento no vacío con su # inicial, o "" si el fragmento está vacío o no existe. url.href devuelve la URL serializada completa, incluida la cadena de consulta si existe. Un # final en href distingue un fragmento vacío de uno ausente.

Asigna el texto del fragmento a url.hash con o sin # inicial. Los caracteres que lo requieren, como los espacios, se codifican con porcentajes, pero no se decodifican automáticamente al leer la propiedad. url.hash = "" elimina el fragmento; url.hash = "#" deja un fragmento vacío. El fragmento es independiente de la consulta: url.searchParams gestiona los parámetros de consulta y el fragmento no se envía automáticamente al servidor en una solicitud HTTP.

Al asignar un valor a url.href, se analiza el nuevo valor y se sustituye la URL completa en el mismo objeto. Si falla el análisis, se lanza TypeError. El setter no resuelve referencias relativas respecto a la URL actual; para ello, usa new URL(relative, base).href con una base válida.

Modificar un objeto URL no provoca una navegación, a diferencia de asignar un valor a window.location.href. Antes de navegar a una URL no fiable, comprueba que su esquema y su origen estén permitidos: que pueda analizarse no significa que sea segura. URL es una API de la plataforma web, no forma parte de ECMAScript 2024; su disponibilidad depende del entorno de ejecución.

Ejemplos

{
  const url = new URL("https://example.com/guide?lang=en");
  const show = () => console.log(JSON.stringify([url.hash, url.href]));

  url.hash = "quick start";
  show();

  url.hash = "#";
  show();

  url.hash = "";
  show();

  url.href = "https://example.org/start#intro";
  show();
}

Resultado

["#quick%20start","https://example.com/guide?lang=en#quick%20start"]
["","https://example.com/guide?lang=en#"]
["","https://example.com/guide?lang=en"]
["#intro","https://example.org/start#intro"]

Cada línea muestra `[hash, href]`. Fíjate en `%20`, en el `#` final que solo aparece en la segunda línea y en la sustitución de toda la URL en la última.

Lecciones relacionadas

  • JavaScript · Lección 30 · Avanzado · Versión: 4

Fuentes