Share via

Web.BrowserContents

  • 發行項

語法

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

關於

傳回所指定 url 的 HTML，如網頁瀏覽器的檢視內容。 可提供選擇性記錄參數 options 來指定其他屬性。 記錄可包含下列欄位：

  • ApiKeyName：若目標網站有 API 金鑰標記法，則此參數可以用來指定必須在 URL 中使用的金鑰參數名稱 (而非值)。 實際的金鑰值會在認證中提供。
  • WaitFor：指定在下載 HTML 前除了等待頁面載入 (這一律會完成) 以外的等待條件。 可以是包含 Timeout 和/或 Selector 欄位的記錄。 如果只指定 Timeout，則函式會先等待指定的時間長度，再下載 HTML。 如果同時指定 Selector 和 Timeout，且 Timeout 在 Selector 出現於頁面上之前就已結束，即會擲回錯誤。 若指定 Selector 但未指定 Timeout，會套用預設為 30 秒的 Timeout。

範例 1

傳回 https://microsoft.com 的 HTML。

使用方式

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

輸出

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

範例 2

等待 CSS 選取器出現之後，傳回 https://microsoft.com 的 HTML。

使用方式

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

輸出

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

範例 3

在等待十秒後傳回 https://microsoft.com 的 HTML。

使用方式

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

輸出

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

範例 4

等待 CSS 選取器出現 (最長 10 秒) 之後，傳回 https://microsoft.com 的 HTML。

使用方式

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

輸出

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