Comment utiliser l'environnement d'exécution HTML dans Python
Certaines opérations HTML supposent un environnement de navigation : une fenêtre, un emplacement, le stockage, la diffusion d’événements. Aspose.HTML FOSS pour Python modélise cet environnement en Python pur — Window, Navigator, Location, History, Storage, la famille Event, et les observateurs — de sorte que ces documents sont traités côté serveur. Ce guide parcourt la couche, en utilisant pip pour l’installation.
Guide étape par étape
Étape 1 : installer le paquet
git clone https://github.com/aspose-html-foss/Aspose.HTML-FOSS-for-Python.git
cd Aspose.HTML-FOSS-for-Python
pip install -e .Étape 2 : importer les classes requises
from aspose_html.dom import Window, EventTarget, AbortControllerÉtape 3 : savoir quand vous avez besoin de l’environnement
L’analyse, le CSSOM et la mise en page ne nécessitent jamais de fenêtre. N’utilisez cette couche que lorsque le traitement d’un document dépend de l’état de l’environnement — navigation, stockage, événements ou observateurs.
Étape 4: Utiliser les objets d’environnement
Window ancre l’environnement avec WindowEventLoop qui pilote l’émission; Location et History modélisent l’état de navigation; Storage modélise le stockage web clé-valeur; l’identité Navigator est configurable via set_default_user_agent(). Les événements sont émis via EventTarget avec la famille standard Event, et AbortController/AbortSignal offrent l’annulation.
Problèmes courants et correctifs
Un document traité s’attend à des globales de fenêtre. Il a été rédigé pour les navigateurs — fournissez le Window couche d’environnement.
Les écouteurs d’événements enregistrés ne se déclenchent jamais. L’envoi nécessite la boucle d’événements; alimentez-la avec WindowEventLoop.
Des branches logiques sur l’agent utilisateur se déclenchent de façon inattendue. Le défaut Navigator identité est en vigueur — définissez-la avec set_default_user_agent().
Foire aux questions
La couche d’environnement est-elle requise pour l’analyse?
Non — c’est optionnel; les couches d’analyse et de style en sont indépendantes.
Quels types d’événements sont modélisés?
La famille standard: UI, mouse, keyboard, focus, input, popstate, hashchange, error, et custom events.
Le Storage est-il persistant sur le disque?
Storage modélise la surface API; la persistance est laissée à l’application d’intégration.
