Come lavorare con gli URL in Python

Il livello URL di Aspose.HTML FOSS per Python implementa l’analisi in stile WHATWG, quindi gli URL trovati nei documenti vengono risolti e normalizzati come li trattano i browser. Questa guida copre l’analisi, la validazione, le stringhe di query e il modello di errore, utilizzando pip per l’installazione.

Guida passo-passo

Passo 1: Installa il pacchetto

git clone https://github.com/aspose-html-foss/Aspose.HTML-FOSS-for-Python.git
cd Aspose.HTML-FOSS-for-Python
pip install -e .

Passo 2: Importa le classi richieste

from aspose_html.url import URL, URLSearchParams

Passo 3: Analizza e valida

URL.parse() analizza URL assoluti o relativi (con una base); URL.can_parse() risponde alla validità in modo economico senza costruire un oggetto; i fallimenti di parsing sollevano il URLParseError tipizzato.

Passo 4: Modifica le stringhe di query

URLSearchParams mantiene i parametri di query in round-trip — append(), get(), get_all(), has() e delete() — preservando la semantica multi-valore per le chiavi ripetute.

Problemi comuni e soluzioni

Un URL relativo non riesce a essere analizzato. L’analisi relativa richiede un URL di base — forniscine uno a URL.parse().

Viene restituito solo il primo valore di una chiave ripetuta. get() restituisce la prima corrispondenza per progettazione; usa get_all() per ogni valore.

I componenti appaiono normalizzati o percent-encoded in modo inatteso. Normalizzazione WHATWG in azione — l’output corrisponde al comportamento del browser.

Domande frequenti

Come posso convalidare un URL senza analizzarlo?

URL.can_parse() restituisce un booleano senza costruzione di oggetti.

Le chiavi di query sono sensibili al maiuscolo/minuscolo?

Sì — le chiavi sono confrontate così come sono, coerenti con lo standard URL.

Quale tipo di errore sollevano i fallimenti di parsing?

Il URLParseError tipizzato — catturarlo invece di pre-validare con espressioni regolari.