Web.BrowserContents
Web ブラウザーで表示される、指定された URL の HTML を返します。
Syntax
Web.BrowserContents(
url as text,
optional options as record
) as text
Remarks
指定された url
に関して、Web ブラウザーで表示されるとおりの HTML を返します。省略可能なレコード パラメーター options
を設定して追加のプロパティを指定することもできます。レコードには、次のフィールドを含めることができます。
ApiKeyName
: 対象サイトに API キーの概念がある場合、このパラメーターを使用して、URL で使用する必要があるキー パラメーターの名前 (値ではありません) を指定できます。実際のキー値は資格情報で提供されています。WaitFor
: ページの読み込みの待機 (必ず生じます) に加えて、HTML をダウンロードする前に待機する条件を指定します。Timeout および Selector のフィールド (あるいはその一方) を含むレコードとすることができます。Timeout のみを指定すると、関数は、HTML をダウンロードする前に、指定の時間待機します。Selector と Timeout の両方を指定した場合、ページに Selector が存在するようになる前に Timeout の有効期限が切れると、エラーがスローされます。Timeout を指定しないで Selector のみを指定すると、既定の Timeout である 30 秒が適用されます。
Examples
Example #1
https://microsoft.com の HTML を返します。
Web.BrowserContents("https://microsoft.com")
Result:
"<!DOCTYPE html><html xmlns=..."
Example #2
CSS セレクターが存在するようになるのを待ってから、https://microsoft.com の HTML を返します。
Web.BrowserContents("https://microsoft.com", [WaitFor = [Selector = "div.ready"]])
Result:
"<!DOCTYPE html><html xmlns=..."
Example #3
10 秒間待った後、https://microsoft.com の HTML を返します。
Web.BrowserContents("https://microsoft.com", [WaitFor = [Timeout = #duration(0,0,0,10)]])
Result:
"<!DOCTYPE html><html xmlns=..."
Example #4
CSS セレクターが存在するようになるのを最大 10 秒待ってから、https://microsoft.com の HTML を返します。
Web.BrowserContents("https://microsoft.com", [WaitFor = [Selector = "div.ready", Timeout = #duration(0,0,0,10)]])
Result:
"<!DOCTYPE html><html xmlns=..."
Category
データにアクセスしています