Saltar para o conteúdo principal

Web.BrowserContents

Devolve o HTML para o URL especificado, conforme visualizado por um browser.

Syntax

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

Remarks

Devolve o HTML para o url especificado, conforme visualizado por um browser. Pode ser fornecido um parâmetro de options opcional para especificar propriedades adicionais. O registo pode conter os seguintes campos:

  • ApiKeyName: se o site de destino tiver uma noção de uma chave de API, este parâmetro pode ser utilizado para especificar o nome (e não o valor) do parâmetro da chave que tem de ser utilizado no URL. O valor da chave em questão é fornecido na credencial.
  • WaitFor: especifica uma condição para aguardar antes de transferir o HTML, além de aguardar que a página seja carregada (o que é sempre efetuado). Pode ser um registo que contém os campos Tempo Limite e/ou Seletor. Se for especificado apenas um Tempo Limite, a função aguardará o período de tempo especificado antes de transferir o HTML. Se for especificado um Seletor e um Tempo Limite e o Tempo Limite ocorrer antes de o Seletor existir na página, será apresentada uma mensagem de erro. Se for especificado um Seletor sem Tempo Limite, será aplicado um Tempo Limite predefinido de 30 segundos.

Examples

Example #1

Devolve o HTML para https://microsoft.com.

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

Result:

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

Example #2

Devolve o HTML para https://microsoft.com após aguardar que um seletor CSS exista.

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

Result:

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

Example #3

Devolve o HTML para https://microsoft.com após aguardar dez segundos.

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

Result:

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

Example #4

Devolve o HTML para https://microsoft.com após aguardar até dez segundos para que o seletor CSS exista.

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

Result:

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

Category

A aceder aos dados