Como usar o contexto JavaScript em Python
A camada de script do Aspose.HTML FOSS para Python é explícita e orientada por políticas: nada é executado durante a análise, e quando você avalia scripts, o JSContext os executa com acesso a módulos controlado por ModuleRegistry e ModuleLoadPolicy. Este guia explica as partes e o modelo de falha, usando pip para instalação.
Guia Passo a Passo
Etapa 1: Instalar o Pacote
git clone https://github.com/aspose-html-foss/Aspose.HTML-FOSS-for-Python.git
cd Aspose.HTML-FOSS-for-Python
pip install -e .Etapa 2: Importar as Classes Necessárias
from aspose_html.js import JSContext, ModuleRegistry, ModuleLoadPolicyEtapa 3: Entender o Modelo de Avaliação
JSContext hospeda a avaliação. Falhas de script aparecem como o JSEvaluationError tipado no lado Python, mantendo os bugs de script distintos dos bugs do pipeline.
Etapa 4: Controle de Acesso ao Módulo
ModuleRegistry mapeia especificadores de módulo para implementações — o registro é a sandbox. Módulos ausentes levantam o ModuleNotFoundError tipado da biblioteca; ModuleLoadPolicy governa o que um contexto pode carregar.
Problemas Comuns e Correções
A avaliação gera ModuleNotFoundError. O script importa um módulo que você não registrou — adicione-o a ModuleRegistry ou trate o erro como um sinal de política.
Uma falha de script trava o pipeline. Catch JSEvaluationError na fronteira da avaliação.
Scripts acessam mais do que o pretendido. Tighten ModuleLoadPolicy e reduza o registro — registros pequenos são o objetivo.
Perguntas Frequentes
Os scripts são executados durante a análise?
Não. A análise nunca executa scripts; a avaliação é explícita através de JSContext.
Como isolar o comportamento de scripts?
Registre apenas os módulos necessários em ModuleRegistry e restrinja o carregamento com ModuleLoadPolicy.
Como os erros de script aparecem em Python?
Como exceções JSEvaluationError.
