Troubleshooting
Correções para os problemas que surgem com mais frequência no Aspose.HTML FOSS para Python, agrupados por camada.
Estilos e a Cascata
Uma regra de stylesheet não tem efeito. A sheet deve ser anexada com Document.attach_style_sheet() before Element.get_computed_style() é chamado. Sheets não anexadas nunca participam da cascade.
Uma declaração inline perde para uma regra de stylesheet. Regras Author marcadas !important têm precedência sobre declarações inline não importantes. Verifique com CSSStyleDeclaration.get_property_priority().
Duas regras empatam e a “errada” vence. Empates de especificidade igual são resolvidos pela ordem das regras — regras posteriores vencem. Compare tuplas com specificity() em caso de dúvida.
Um valor herdado não chega a um filho. Valores locais sempre substituem os herdados, e nem toda propriedade é herdada. Leia primeiro o valor computado do pai para confirmar o que deve ser propagado.
Análise e o DOM
Marcações malformadas são analisadas sem erro. Comportamento padrão: a construção da árvore define a recuperação para cada caso de erro. Se precisar detectar problemas, inspecione o fluxo de tokens via Tokenizer.tokenize().
O conteúdo da tabela aparece fora da sua tabela. O foster parenting realoca o conteúdo de tabela fora de lugar, exatamente como os navegadores fazem. Corrija o aninhamento da fonte.
get_element_by_id() não retorna nada. O elemento deve conter o id atributo e ser anexado à árvore desse documento.
Encodings
Um byte-order mark aparece no texto decodificado. Use detect_encoding() — ele remove bytes BOM de result.text. A decodificação manual os deixa dentro.
Dois rótulos para a mesma codificação são comparados como diferentes. Normalize ambos com get_canonical_name(); latin1 and iso-8859-1 são ambos windows-1252 canonicamente.
Scripts
A avaliação gera ModuleNotFoundError. O script importa um módulo que não está presente em ModuleRegistry. Registre-o ou trate o erro como seu sandbox funcionando como esperado.
Uma falha no script derruba a pipeline. Catch JSEvaluationError na fronteira da avaliação — é o sinal tipado para falhas do lado do script.
