[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/Element/getHTML [Back]  [Original]

Element : mthode getHTML() - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Element : mthode getHTML()

Baseline 2024
Nouvellement disponible

Depuis septembre 2024, cette fonctionnalit fonctionne sur les appareils et les versions de navigateur les plus rcents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La mthode getHTML() de l'interface Element est utilise pour srialiser le DOM d'un lment en une chane de caractres HTML.

La mthode fournit un argument options qui permet la srialisation des nuds enfants qui sont des racines d'ombre. Les options peuvent tre utilises pour inclure des racines d'ombre imbriques qui ont t dfinies comme serializable, et/ou un tableau dfini d'objets ShadowRoot, qui peuvent tre ouverts ou ferms.

Sans arguments, les nuds enfants qui sont des racines d'ombre ne sont pas srialiss, et cette mthode se comporte de la mme manire que la lecture de la valeur de Element.innerHTML.

Notez que certains navigateurs srialisent les caractres < et > en &lt; et &gt; lorsqu'ils apparaissent dans les valeurs d'attribut (voir Compatibilit des navigateurs). Ceci est pour prvenir une vulnrabilit de scurit potentielle (mutation XSS (angl.)) dans laquelle une attaquante peut crer une entre qui contourne une fonction d'assainissement, permettant une attaque de type script inter-site (XSS).

Dans cet article

Syntaxe

js
getHTML(options)

Paramtres

options Facultatif

Un objet d'options avec les paramtres optionnels suivants :

serializableShadowRoots

Une valeur boolenne qui dfinit si les racines d'ombre serializable doivent tre incluses. La valeur par dfaut est false.

shadowRoots

Un tableau d'objets ShadowRoot srialiser. Ils sont inclus indpendamment du fait qu'ils soient marqus comme serializable, ou s'ils sont ouverts ou ferms. La valeur par dfaut est un tableau vide.

Valeur de retour

Une chane de caractres reprsentant la srialisation HTML de l'lment.

Exceptions

Aucune.

Spcifications

Spcification
HTML
# dom-element-gethtml

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page