Livro de receitas da API da Web

Capítulo 3. URLs e encaminhamento

Este trabalho foi traduzido com recurso a IA. Agradecemos o teu feedback e comentários: [e-mail]

Introdução

A maioria das páginas e aplicações Web lida com URLs de alguma forma. Pode ser uma ação como criar uma ligação com determinados parâmetros de consulta ou um encaminhamento baseado em URL numa aplicação de página única (SPA).

Um URL é apenas uma cadeia de caracteres que obedece a algumas regras de sintaxe definidas no RFC 3986, "Uniform Resource Identifier (URI): Generic Syntax". Há várias partes componentes de um URL que podes precisar de analisar ou manipular. Fazer isso com técnicas como expressões regulares ou concatenação de strings nem sempre é confiável.

Atualmente, os browsers suportam a API de URL. Esta API fornece um construtor URL que pode criar, derivar e manipular URLs. Esta API era algo limitada no início, mas as actualizações posteriores adicionaram utilitários como a interface URLSearchParams que simplificou a construção e a leitura de cadeias de consulta.

Partes de um URL

Quando chama o construtor URL com uma cadeia de caracteres que representa um URL válido, o objeto resultante contém propriedades que representam as diferentes partes componentes do URL. A Figura 3-1 mostra as mais utilizadas:

protocol (1)

Para URLs da Web, isto é tipicamente http: ou https: (nota que os dois pontos estão incluídos, mas não as barras). São possíveis outros protocolos, como file: (para um ficheiro local não alojado ...