Troubleshooting
Correctifs pour les problèmes qui surviennent le plus souvent avec Aspose.HTML FOSS pour Python, regroupés par couche.
Styles et cascade
Une règle de feuille de style n’a aucun effet. La feuille doit être attachée avec Document.attach_style_sheet() before Element.get_computed_style() est appelée. Les feuilles détachées ne participent jamais à la cascade.
Une déclaration en ligne perd face à une règle de feuille de style. Les règles d’auteur marquées !important priment sur les déclarations en ligne non importantes. Vérifiez avec CSSStyleDeclaration.get_property_priority().
Deux règles sont à égalité et la “wrong” l’emporte. Les égalités de spécificité égale se résolvent par l’ordre des règles — les règles ultérieures gagnent. Comparez les tuples avec specificity() en cas de doute.
Une valeur héritée n’atteint pas un enfant. Les valeurs locales remplacent toujours les valeurs héritées, et toutes les propriétés ne sont pas héritées. Lisez d’abord la valeur calculée du parent afin de confirmer ce qui doit être transmis.
Analyse et le DOM
Un balisage malformé est analysé sans erreur. Comportement standard : la construction de l’arbre définit la récupération pour chaque cas d’erreur. Si vous devez détecter les problèmes, inspectez le flux de jetons via Tokenizer.tokenize().
Le contenu du tableau apparaît en dehors de son tableau. Le foster parenting a relocalisé le contenu de tableau mal placé, exactement comme le font les navigateurs. Corrigez l’imbrication source.
get_element_by_id() ne renvoie rien. L’élément doit porter le id attribut et être attaché à l’arbre de ce document.
Encodings
Un byte-order mark apparaît dans le texte décodé. Utilisez detect_encoding() — il supprime les octets BOM de result.text. Le décodage manuel les laisse dans.
Deux libellés pour le même encodage ne sont pas égaux. Normalisez les deux avec get_canonical_name(); latin1 and iso-8859-1 sont tous les deux windows-1252 canoniquement.
Scripts
L’évaluation génère ModuleNotFoundError. Le script importe un module qui n’est pas présent dans ModuleRegistry. Enregistrez-le ou considérez l’erreur comme le comportement prévu de votre sandbox.
Une défaillance du script fait tomber le pipeline. Catch JSEvaluationError à la limite de l’évaluation — c’est le signal typé des échecs côté script.
