Share via

Web.BrowserContents

  • Article

Syntaxe

Web.BrowserContents(url as text, optional options as nullable record) as text

À propos

Retourne le code HTML du url spécifié, tel qu’il est vu par un navigateur web. Vous pouvez fournir un paramètre d’enregistrement facultatif, options, pour spécifier des propriétés supplémentaires. L’enregistrement peut contenir les champs suivants :

  • ApiKeyName : si le site cible utilise une clé d’API, ce paramètre peut être utilisé pour spécifier le nom (pas la valeur) du paramètre de clé qui doit être utilisé dans l’URL. La valeur de clé réelle est fournie dans les informations d’identification.
  • WaitFor : Spécifie l’attente d’une condition avant le téléchargement du code HTML, en plus de l’attente du chargement de la page (ce qui est toujours le cas). Il peut s’agir d’un enregistrement contenant les champs Timeout et/ou Selector. Si seul Timeout est spécifié, la fonction attend la durée indiquée avant de télécharger le code HTML. Si Selector et Timeout sont spécifiés et si la valeur de Timeout s’écoule avant l’existence de Selector dans la page, une erreur est générée. Si Selector est spécifié sans Timeout, une valeur par défaut de 30 secondes est appliquée pour Timeout.

Exemple 1

Retourne le code HTML pour https://microsoft.com.

Utilisation

Web.BrowserContents("https://microsoft.com")

Sortie

"<!DOCTYPE html><html xmlns=..."

Exemple 2

Retourne le code HTML pour https://microsoft.com après avoir attendu l’existence d’un sélecteur CSS.

Utilisation

Web.BrowserContents("https://microsoft.com", [WaitFor = [Selector = "div.ready"]])

Sortie

"<!DOCTYPE html><html xmlns=..."

Exemple 3

Retourne le code HTML pour https://microsoft.com après avoir attendu dix secondes.

Utilisation

Web.BrowserContents("https://microsoft.com", [WaitFor = [Timeout = #duration(0,0,0,10)]])

Sortie

"<!DOCTYPE html><html xmlns=..."

Exemple 4

Retourne le code HTML pour https://microsoft.com après avoir attendu jusqu’à dix secondes l’existence d’un sélecteur CSS.

Utilisation

Web.BrowserContents("https://microsoft.com", [WaitFor = [Selector = "div.ready", Timeout = #duration(0,0,0,10)]])

Sortie

"<!DOCTYPE html><html xmlns=..."