![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D248BE0233D28263F53/de_DE/fbd8d40651fff19a46e7aaedd4cb1b09.png)
Einführung in die Aktion „JavaScript auf Webseite ausführen“ in der App „Kurzbefehle“ auf dem Mac
Nahezu alle Webseiten verwenden JavaScript, eine Programmiersprache, mit der dynamische Effekte wie Animationen, interaktive Menüs und Videowiedergabe in Webbrowsern erstellt werden. Im Allgemeinen ist JavaScript beim Anzeigen einer Website nicht zu sehen. Wenn du allerdings einen Kurzbefehl erstellst, der die Aktion „JavaScript auf Webseite ausführen“ enthält, und den Kurzbefehl dann in der Safari-App ausführst, kannst du JavaScript auf einer Webseite steuern.
Kurzbefehle, die dein eigenes JavaScript auf einer Webseite ausführen, können auf vielfältige Art und Weise verwendet werden. So kannst du beispielsweise einen Kurzbefehl erstellen, der bestimmte Daten von einer Webseite abruft, diese Daten in eine Aufgabe wie das Extrahieren eines Stundenplans einbezieht und die Aufgabe zur App „Kalender“ hinzufügt, oder der die Mitglieder einer Gruppe eines sozialen Netzes exportiert und diese Daten zu einer Tabelle hinzufügt.
Darüber hinaus können Kurzbefehle erstellt werden, anhand denen eine Webseite geändert werden kann, wie das Ändern der Schriftgröße einer Webseite oder das Ändern der Geschwindigkeit, in der ein Video wiedergegeben wird. Damit du JavaScript über einen Kurzbefehl ausführen kannst, musst du zuerst die Einstellung aktivieren. Weitere Informationen findest du unter Erweiterte Datenschutz- und Sicherheitseinstellungen in der App „Kurzbefehle“ auf dem Mac.
Weitere Informationen zum Verwenden von Kurzbefehlen, die JavaScript auf einer Webseite ausführen, findest du unter Verwenden der Aktion „JavaScript auf Webseite ausführen“ in der App „Kurzbefehle“ auf dem Mac.
Webseitendaten abrufen
Mit der Aktion „JavaScript auf Webseite ausführen“ können Daten von einer Webseite abgerufen werden, indem alle Elemente, die bestimmten Kriterien entsprechen, iteriert werden, um mit den Daten eine Aufgabe auszuführen (oder um die Elemente weiter zu inspizieren).
Um zum Beispiel eine Liste mit jedem Bildelement auf einer Webseite zu erstellen, verwende:
var elements = document.querySelectorAll("img");
Wenn du beispielsweise jedes Element der Klasse „post“ abrufen möchtest, verwende:
var elements = document.querySelectorAll("img");
Sobald eine NodeList erstellt wurde, kannst du die Elemente iterieren, um zum Beispiel Elemente zu filtern oder zu einer Datenstruktur hinzuzufügen. Verwende dazu:
var elements = ...;
for (let element of elements) {
// ...
}
Weitere Informationen zu Suchergebnissen auf Webseiten findest du unter https://developer.mozilla.org/Selectors und https://developer.mozilla.org/SelectorAll.
Eingabe für die Aktion „JavaScript auf Webseite ausführen“
Bei der Eingabe für die Aktion „JavaScript auf Webseite ausführen“ muss es sich um eine aktive Safari-Webseite handeln, d. h. der Kurzbefehl muss über das Share-Sheet ausgeführt werden (und zwar von Safari, SFSafariViewController oder ASWebAuthenticationSession).
Wird ein Kurzbefehl vom Share-Sheet aus ausgeführt, wird die Eingabe von der Safari-App an die erste Aktion deines Kurzbefehls übergeben.
Bei der Eingabe für die Aktion „JavaScript auf Webseite ausführen“ muss es sich zwar um eine Safari-Webseite handeln, allerdings kannst du zusätzliche Daten zur Aktion hinzufügen, indem du magische Variablen verwendest. Der Kurzbefehl „Videogeschwindigkeit ändern“ (in der Galerie verfügbar) enthält eine Aktion „JavaScript auf Webseite ausführen“, die ein Video auf einer Webseite ändert. Das Wiedergabetempo des Videos wird von der Variable „Geschwindigkeit“ gesteuert.
Informationen zum Verwenden von Kurzbefehlen in Safari findest du unter Ausführen eines Kurzbefehls beim Arbeiten auf dem Mac.
Ausgabe für die Aktion „JavaScript auf Webseite ausführen“
Um Daten zurückzugeben, muss der Completion Handler in JavaScript, wie zum Beispiel completion(result)
, aufgerufen werden. Da JavaScript üblicherweise mit asynchronen Mustern verwendet wird, ist der Aufruf absichtlich nicht synchron. Dadurch kann die Aktion asynchron beendet werden. So ist beispielsweise das Folgende gültig:
window.setTimeout(function() {
completion(true);
}, 1000);
Bei der Ausgabe der Aktion „JavaScript auf Webseite ausführen“ handelt es sich um beliebige gültige JSON-Datentypen, einschließlich:
Zeichenkette
Zahl
Boolesches Attribut (true oder false)
Array (mit anderem gültigem JSON-Datentyp)
Wörterbuch (mit anderem gültigem JSON-Datentyp)
Null
Nicht definiert
„Kurzbefehle“ codiert und decodiert deinen zurückgegebenen Wert zur Kommunikation zwischen JavaScript und der Kurzbefehle-App. Das bedeutet, dass JSON.stringify(result)
vor dem Aufruf des Completion Handlers nicht aufgerufen werden muss.
Da es sich beim Rückgabewert um JSON handelt, funktionieren bestimmte Rückgabewerte nicht sehr gut. Beispiel: eine Funktion oder ein Node beinhaltet keine nützliche JSON-codierte Repräsentation. Wenn das der Fall ist, erstelle ein Array/Wörterbuch mit den benötigten JSON-kompatiblen Werten.
Hinweis: Weil es sich bei einem Objekt in JavaScript einfach um ein Wörterbuch handelt, werden Objekte auch zu JSON konvertiert.
Wenn von der Aktion „JavaScript auf Webseite ausführen“ keine Daten zurückgegeben werden sollen, kannst du completion()
ohne Funktionsargument aufrufen (bei undefined
handelt es sich um eine gültige Ausgabe). Dies entspricht auch der Funktion completion(undefined)
.
Weitere Informationen zu JSON findest du unter Einführung in die Verwendung von JSON in der App „Kurzbefehle“ auf dem Mac.
Weitere Informationen zu Knoten findest du unter https://developer.mozilla.org/Node.
Weitere Informationen zu Funktionen findest du unter https://developer.mozilla.org/Functions.
Zeitlimit für die Aktion „JavaScript auf Webseite ausführen“
Wie alle JavaScript-Erweiterungen in Safari hat die Aktion „JavaScript auf Webseite ausführen“ ihr eigenes Zeitlimit und sollte so schnell wie möglich fertig ausgeführt werden. JavaScript, das synchrone Funktionen verwendet, wird möglicherweise nicht rechtzeitig fertig ausgeführt, einschließlich:
window.alert()
window.prompt()
window.confirm()
Zeitüberschreitungen, die mehrere Sekunden dauern – zum Beispiel:
window.setTimeout(function() { completion(); }, 5000);
Wenn dein JavaScript das Zeitlimit überschreitet, wird der Kurzbefehl nicht abgeschlossen und eine Fehlermeldung „JavaScript-Zeitüberschreitung“ wird angezeigt, wenn du den Kurzbefehl ausführst.
Handhabung von Syntax- und Ausführungsfehlern
Du kannst eine beliebige Syntax verwenden (wenn diese in Safari unterstützt wird), um in der Aktion „JavaScript auf Webseite ausführen“ JavaScript zu schreiben.
In der App „Kurzbefehle“ hilft die Aktion „JavaScript auf Webseite ausführen“ dir dabei, Fehler zu identifizieren, bevor du den Kurzbefehl von der Safari-Erweiterung aus ausführst, indem eine einfache Syntax-Überprüfung durchgeführt wird.
Während du dein Skript in das Textfeld eingibst, stellt die Syntax-Hervorhebung sicher, dass dein JavaScript gültig ist. Wenn du beispielsweise vergisst, am Ende einer Zeichenkette Anführungsstriche hinzuzufügen, wird der nachfolgende Text hervorgehoben.
Wenn die Syntax deines Skripts gültig ist aber die Ausführung fehlerhaft, findet die Aktion „JavaScript auf Webseite ausführen“ die Ausnahmen und zeigt sie dir an. Beispiel: Wenn dein Skript auf eine Variable oder Funktion verweist, die nicht existiert (wie shortcuts.completion()
), wird beim Ausführen ein Fehler angezeigt.