Úvod do akce „Spustit JavaScript na webové stránce“ ve Zkratkách na iPhonu nebo iPadu
Téměř všechny webové stránky využívají skripty v JavaScriptu, programovacím jazyku, který umožňuje vytvářet ve webových prohlížečích dynamické efekty, jako jsou animace, interaktivní nabídky, přehrávání videa a další. Při prohlížení webových stránek obecně nemáte k JavaScriptu přímý přístup. Pokud však vytvoříte zkratku, která obsahuje akci „Spustit JavaScript na webové stránce“, a potom tuto zkratku spustíte v aplikaci Safari, můžete JavaScript na webové stránce ovládat.
Zkratky, které na webové stránce spouštějí vlastní JavaScript, mají nespočet různých využití. Mimo jiné můžete tímto způsobem vytvořit zkratky, které z webové stránky načtou určité údaje a tyto údaje pak použijí v další úloze, například načtou rozvrh hodin a přidají ho do aplikace Kalendář nebo vyexportují informace o členech skupiny na sociální síti a vloží je do tabulky.
Můžete vytvořit i zkratky, které vám umožní webovou stránku změnit, například zobrazit její text jiným písmem nebo změnit rychlost přehrávání videa. Před spuštěním JavaScriptu pomocí zkratky musíte toto nastavení povolit. Viz Pokročilé nastavení soukromí a zabezpečení ve Zkratkách na iPhonu nebo iPadu.
Informace o používání zkratek, které spouštějí JavaScript na webové stránce, viz Použití akce „Spustit JavaScript na webové stránce“ ve Zkratkách na iPhonu nebo iPadu.
Informace o načítání dat z webových stránek
Akce „Spustit JavaScript na webové stránce“ vám umožňuje načíst data z webové stránky pomocí skriptu, který extrahuje všechny prvky splňující určitá kritéria a potom tyto prvky postupně projde a s každým provede určitou úlohu (nebo jednotlivé prvky dále analyzuje).
Chcete‑li například vytvořit seznam všech obrázkových prvků na stránce, použijte následující příkaz:
var prvky = document.querySelectorAll("img");
Jiným příkladem může být načtení všech prvků třídy „post“:
var prvky = document.querySelectorAll(".post");
Po vytvoření seznamu NodeList můžete postupně procházet jednotlivé prvky (a dále je filtrovat nebo přidávat do datové struktury) pomocí cyklu:
var elements = ...;for (let element of elements) { // ...}Další informace o dotazování na výsledky z webových stránek viz https://developer.mozilla.org/Selectors a https://developer.mozilla.org/SelectorAll.
Vstup akce „Spustit JavaScript na webové stránce“
Vstupem akce „Spustit JavaScript na webové stránce“ musí být aktivní webová stránka v Safari, což znamená, že zkratku musíte spustit z listu sdílení (v Safari konkrétně SFSafariViewController nebo ASWebAuthenticationSession).
Při spuštění zkratky z listu sdílení je vstup z aplikace Safari předán první akci ve zkratce.
Vstupem akce „Spustit JavaScript na webové stránce“ sice musí být webová stránka v Safari, pomocí automatických proměnných do ní však můžete vložit další data. Například zkratka Změnit rychlost videa (dostupná v galerii) obsahuje akci „Spustit JavaScript na webové stránce“, která na stránkách upravuje video. Proměnná Speed určuje rychlost přehrávání videa.
Informace o spouštění zkratek ze Safari najdete v tématu Spuštění zkratky z jiné aplikace na iPhonu nebo iPadu.
Výstup akce „Spustit JavaScript na webové stránce“
Pokud má tato akce vracet data, musíte v JavaScriptu vyvolat obslužnou rutinu dokončení, např. completion(výsledek). Protože se JavaScript obvykle používá v asynchronních konstrukcích, toto volání záměrně není synchronní. Akci tak lze dokončit asynchronně. Např. následující kód je platný:
window.setTimeout(function() { completion(true);}, 1000);Výstup akce „Spustit JavaScript na webové stránce“ může být libovolného platného datového typu JSON, mezi něž patří:
Řetězec
Číslo
Logická hodnota (true nebo false)
Pole (obsahující libovolný jiný platný typ JSON)
Slovník (obsahující libovolný jiný platný typ JSON)
Null
Nedefinováno
Aplikace Zkratky na pozadí automaticky kóduje a dekóduje vrácené hodnoty tak, aby mohla s JavaScriptem komunikovat. Před voláním obslužné rutiny dokončení tedy nemusíte volat JSON.stringify(výsledek).
Vzhledem k tomu, že návratová hodnota je ve formátu JSON, některé návratové hodnoty není vhodné používat. Kupříkladu pro funkce nebo objekty Node neexistuje v kódování JSON použitelná reprezentace. V takovém případě se doporučuje vytvořit pole nebo slovník obsahující potřebné hodnoty, které budou kompatibilní s formátem JSON.
Poznámka: Protože objekty jsou v JavaScriptu implementovány jako jednoduché slovníkové struktury, převod základních objektů do formátu JSON funguje dobře.
Pokud chcete, aby akce „Spustit JavaScript na webové stránce“ nevracela žádná data, můžete funkci completion() volat bez parametru (protože hodnota undefined je platný výstup). Výsledek je totožný s voláním completion(undefined).
Další informace o formátu JSON najdete v části Úvod do používání formátu JSON ve Zkratkách na iPhonu a iPadu.
Informace o objektech Node viz https://developer.mozilla.org/Node.
Informace o funkcích viz https://developer.mozilla.org/Functions.
Časový limit akce „Spustit JavaScript na webové stránce“
Tak jako pro všechna javascriptová rozšíření v Safari platí i pro akci „Spustit JavaScript na webové stránce“ časový limit a je třeba, aby skončila co nejrychleji. JavaScript nemusí skončit včas, pokud používá synchronní funkce, například:
window.alert()window.prompt()window.confirm()Několikasekundové časové limity, např.:
window.setTimeout(function() { completion(); }, 5000);
Pokud kód v JavaScriptu překročí časový limit, zkratka nedoběhne do konce a při jejím spuštění se zobrazí chybová zpráva Vypršel časový limit JavaScriptu.
Ošetření syntaktických a běhových chyb
Při psaní skriptů v akci „Spustit JavaScript na webové stránce“ můžete používat libovolnou syntaxi, kterou Safari podporuje.
Akce „Spustit JavaScript na webové stránce“ v aplikaci Zkratky provádí před spuštěním zkratky v rozšíření Safari základní syntaktickou kontrolu a pomáhá vám tak odhalit chyby.
Při zadávání skriptu do textového pole se aktivuje zvýrazňování syntaxe, takže můžete snáz zkontrolovat platnost JavaScriptu. Jestliže například zapomenete na uvozovky na konci řetězce, zvýrazní se celý text, který za řetězcem následuje.
Pokud je syntaxe skriptu platná, ale při jeho zpracování dojde k běhové chybě, akce „Spustit JavaScript na webové stránce“ zachytí a zobrazí výjimky. Odkazuje‑li váš skript například na neexistující proměnnou či funkci (např. shortcuts.completion()), za běhu se zobrazí chyba.