Як використовувати середовище виконання HTML у Python

Деяка обробка HTML передбачає середовище браузера: вікно, місце розташування, сховище, розсилку подій. Aspose.HTML FOSS для Python моделює це середовище у чистому Python — Window, Navigator, Location, History, Storage, сімейство Event та спостерігачі — тому такі документи обробляються на боці сервера. Цей посібник ознайомлює з шаром, використовуючи pip для встановлення.

Покроковий посібник

Крок 1: Встановити пакет

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

Крок 2: Імпортувати потрібні класи

from aspose_html.dom import Window, EventTarget, AbortController

Крок 3: Зрозуміти, коли потрібне середовище

Парсинг, CSSOM та розмітка ніколи не потребують вікна. Звертайтеся до цього шару лише коли обробка документа залежить від стану середовища — навігації, сховища, подій або спостерігачів.

Крок 4: Використовуйте об’єкти середовища

Window закріплює середовище за допомогою WindowEventLoop, що керує диспетчером; Location і History моделюють стан навігації; Storage моделює веб-сховище ключ-значення; Navigator ідентифікатор налаштовується через set_default_user_agent(). Події диспетчеризуються через EventTarget зі стандартною сімейством Event, а AbortController/AbortSignal забезпечують скасування.

Типові проблеми та виправлення

Оброблений документ очікує глобальні змінні window. Він був створений для браузерів — забезпечте його Window шар середовища.

Зареєстровані обробники подій ніколи не спрацьовують. Dispatch потребує циклу подій; керуйте ним за допомогою WindowEventLoop.

Логічні гілки за User Agent працюють несподівано. Типовий Navigator ідентифікатор діє — встановіть його за допомогою set_default_user_agent().

Поширені питання

Чи потрібен шар середовища для парсингу?

Ні — він є необов’язковим; шари парсингу та стилізації не залежать від нього.

Які типи подій моделюються?

Стандартна сім’я: UI, mouse, keyboard, focus, input, popstate, hashchange, error та custom events.

Чи зберігається Storage на диск?

Storage моделює поверхню API; збереження залишено на вбудованому застосунку.