Macの「ショートカット」の「WebページでJavaScriptを実行」アクションの概要
ほとんどのWebページではJavaScriptを使ってスクリプトが記述されています。JavaScriptは、アニメーション、インタラクティブメニュー、ビデオ再生などの動的なエフェクトを作り出すプログラミング言語です。通常、Webサイトの表示中にJavaScriptがユーザに表示されることはありません。ただし、「WebページでJavaScriptを実行」アクションを含むショートカットを構築してSafari Appから実行すると、WebページのJavaScriptを制御できます。
WebページでカスタムのJavaScriptを実行するショートカットには、さまざまな用途があります。例えば、授業の時間割を抽出して「カレンダー」Appに追加する、ソーシャル・メディア・グループのメンバーデータを書き出してスプレッドシートに追加するなど、Webページから特定のデータを取得してタスクに組み込むショートカットを作成できます。
また、Webページのテキストのフォントを変更する、ビデオの再生速度を変更するなど、Webページを変更できるショートカットも作成できます。ショートカットからJavaScriptを実行する前に、設定を有効にする必要があります。Macの「ショートカット」での高度なプライバシーおよびセキュリティ設定を参照してください。
WebページでJavaScriptを実行するショートカットの使い方については、Macの「ショートカット」の「WebページでJavaScriptを実行」アクションを使うを参照してください。
Webページのデータの取得について
「WebページでJavaScriptを実行」アクションでは、特定の条件に一致するすべての要素を取り込んでから、それらを繰り返し処理してデータでタスクを実行（またはそれらをさらに調査）することで、Webページからデータを取得できます。
例えば、Webページのすべてのイメージ要素のリストを作成するには、以下のスクリプトを使用します:
var elements = document.querySelectorAll("img");
もう1つの例として、classが「post」のすべての要素を取得するには、以下のスクリプトを使用します:
var elements = document.querySelectorAll(".post");
NodeListが作成されたあと、以下のようなスクリプトを使って、それらの要素を繰り返し処理できます（要素をさらに絞り込んだり、要素をデータ構造に追加したりします）。
var elements = ...;for (let element of elements) { // ...}Webページの処理結果のクエリーについて詳しくは、https://developer.mozilla.org/Selectorsおよびhttps://developer.mozilla.org/SelectorAllを参照してください。
「WebページでJavaScriptを実行」アクションの入力
「WebページでJavaScriptを実行」アクションへの入力は、アクティブなSafariのWebページである必要があります。つまり、共有シート（Safariでは具体的にSFSafariViewControllerまたはASWebAuthenticationSession）からショートカットを実行する必要があります。
共有シートからショートカットが実行されると、Safari Appからの入力がショートカットの最初のアクションに渡されます。
「WebページでJavaScriptを実行」アクションへの入力はSafariのWebページである必要がありますが、マジック変数を使ってアクションに追加データを挿入することもできます。例えば、（ギャラリーにある）動画の再生速度を変更するショートカットには、Webページ上の動画を変更する「WebページでJavaScriptを実行」アクションが含まれます。ビデオの再生速度が「速度」変数によって制御されます。
Safariからショートカットを実行する方法については、Macで作業中にショートカットを実行するを参照してください。
「WebページでJavaScriptを実行」アクションの出力
データを返すには、JavaScriptで完了ハンドラ（completion(result) など）を呼び出す必要があります。通常、JavaScriptは非同期パターンで使用されるため、この呼び出しは意図的に同期的ではありません。この方法により、アクションを非同期的に完了できます。例えば、以下のスクリプトは有効です:
window.setTimeout(function() { completion(true);}, 1000);「WebページでJavaScriptを実行」アクションの出力は、以下を含む有効なJSONデータ型です:
String
Number
ブール値（真/偽）
配列（ほかの任意の有効なJSON型を含む）
辞書（ほかの任意の有効なJSON型を含む）
Null
未定義
「ショートカット」では、JavaScriptと「ショートカット」Appの間で通信するために、戻り値が内部で自動的にエンコードされたりデコードされたりします。つまり、完了ハンドラを呼び出す前にJSON.stringify(result)を呼び出す必要はありません。
戻り値はJSONであるため、戻り値が適切に機能しないことがあります。例えば、関数やNodeにはJSONエンコードされた実用的な表現が含まれません。この場合は、必要なJSON互換の値を含む配列または辞書を作成することをおすすめします。
注記: JavaScriptのオブジェクトは単に辞書なので、基本オブジェクトは適切にJSONに変換されます。
「WebページでJavaScriptを実行」アクションからデータを返したくない場合は、関数の引数を指定せずにcompletion()を呼び出すことができます（undefinedは有効な出力であるため）。これは、completion(undefined)の呼び出しと同等です。
JSONについて詳しくは、Macの「ショートカット」でのJSON使用の概要を参照してください。
Nodeについて詳しくは、https://developer.mozilla.org/Nodeを参照してください。
関数について詳しくは、https://developer.mozilla.org/Functionsを参照してください。
「WebページでJavaScriptを実行」アクションの時間制限
「WebページでJavaScriptを実行」アクションは、SafariのすべてのJavaScript機能拡張と同様に時間制限が適用されるため、できるだけ素早く完了する必要があります。同期関数を使用する以下のようなJavaScriptは、時間内に完了しない場合があります:
window.alert()window.prompt()window.confirm()2秒以上のタイムアウト。例:
window.setTimeout(function() { completion(); }, 5000);
JavaScriptが時間制限を超えると、ショートカットを実行しても完了せず、「JavaScriptタイムアウト」エラーメッセージが表示されます。
構文と実行時エラーの処理
Safariでサポートされる任意の構文を使って、「WebページでJavaScriptを実行」アクション内でJavaScriptを記述できます。
「ショートカット」Appでは、Safari機能拡張からショートカットを実行する前に、「WebページでJavaScriptを実行」アクションで基本的な構文チェックを実行してエラーを検出できます。
テキストフィールドへのスクリプトの入力中に、構文の強調表示によって、記述中のJavaScriptが有効であることを確認できます。例えば、文字列の末尾に引用符を入れ忘れると、その文字列の後ろにあるすべてのテキストが強調表示されます。
スクリプトの構文が有効でも実行時エラーが含まれる場合は、「WebページでJavaScriptを実行」アクションによって例外がキャッチされ、表示されます。例えば、存在しない変数または関数（shortcuts.completion() など）がスクリプトで参照されている場合は、実行時にエラーが表示されます。