Introducere în acțiunea “Executare JavaScript pe pagina web” din Scurtături pe iPhone sau iPad
Aproape toate paginile web utilizează script JavaScript, un limbaj de programare care creează efecte dinamice în browserele web, inclusiv animații, meniuri interactive, redare video și altele. În general, scriptul JavaScript nu este expus atunci când vizualizați un site web. Cu toate acestea, prin crearea unei scurtături care conține acțiunea “Executare JavaScript pe pagina web” și apoi executarea scurtăturii din aplicația Safari, puteți controla scriptul JavaScript al unei pagini web.
Scurtăturile care rulează scriptul JavaScript personalizat pe o pagină web au o multitudine de utilizări. De exemplu, puteți crea scurtături care preiau anumite date de pe o pagină web și apoi încorporează respectivele date într-o sarcină, cum ar fi extragerea programului unui curs și apoi adăugarea acestuia în aplicația Calendar sau exportarea datelor membrilor unui grup de pe rețelele de socializare și apoi adăugarea respectivelor date într-o foaie de calcul.
De asemenea, puteți crea scurtături care vă permit să modificați o pagină web, cum ar fi schimbarea fontului textului unei pagini web sau modificarea vitezei de redare a unui clip video. Înainte de a putea executa JavaScript dintr‑o scurtătură, trebuie să activați configurarea. Consultați Configurări avansate de intimitate și securitate în Scurtături pe iPhone sau iPad.
Pentru informații despre utilizarea de scurtături care execută JavaScript pe o pagină web, consultați Utilizarea acțiunii “Executare JavaScript pe pagina web” în Scurtături pe iPhone sau iPad.
Despre extragerea datelor de pe o pagină web
Acțiunea “Executare JavaScript pe pagina web” vă permite să extrageți date dintr-o pagină web prin preluarea tuturor elementelor care corespund anumitor criterii, apoi să iterați prin acele elemente pentru efectuarea unei sarcini cu datele respective (sau pentru inspectarea în continuare a elementelor).
De exemplu, pentru a crea o listă cu toate elementele imagine de pe o pagină web, utilizați:
var elements = document.querySelectorAll("img");
Într-un alt exemplu, pentru a prelua fiecare element cu clasa “post”, utilizați:
var elements = document.querySelectorAll(".post");
După ce se creează un NodeList, puteți itera elementele (pentru a filtra în continuare elementele sau a adăuga elementele la o structură de date) utilizând ceva precum:
var elements = ...;for (let element of elements) { // ...}Pentru informații suplimentare despre interogarea rezultatelor paginii web, consultați https://developer.mozilla.org/Selectors și https://developer.mozilla.org/SelectorAll.
Intrarea acțiunii “Executare JavaScript pe pagina web”
Intrarea acțiunii “Executare JavaScript pe pagina web” trebuie să fie o pagină web Safari activă, iar acest lucru înseamnă că trebuie să executați scurtătura din foaia de partajare (mai exact, din Safari, SFSafariViewController sau ASWebAuthenticationSession).
Când o scurtătură este executată din foaia de partajare, intrarea din aplicația Safari este transmisă în prima acțiune a scurtăturii dvs.
Deși intrarea din acțiunea “Executare JavaScript pe pagina web” trebuie să fie o pagină web Safari, puteți insera date suplimentare în acțiune prin utilizarea variabilelor magice. De exemplu, scurtătura Schimbați viteza video (disponibilă în Galerie) conține o acțiune “Executare JavaScript pe pagina web” care modifică un clip video dintr-o pagină web. Rata de redare a clipului video este controlată de variabila Viteză.
Pentru informații despre executarea scurtăturilor din Safari, consultați Lansarea unei scurtături din altă aplicație pe iPhone sau iPad.
Ieșirea acțiunii “Executare JavaScript pe pagina web”
Pentru a returna date, trebuie să apelați gestionarul de finalizare în JavaScript, de exemplu, completion(result). Deoarece JavaScript este de obicei obișnuit cu tipare asincrone, apelul este intenționat nesincron. Astfel, puteți finaliza acțiunea asincron. De exemplu, următoarea comandă este validă:
window.setTimeout(function() { completion(true);}, 1000);Ieșirea acțiunii “Executare JavaScript pe pagina web” este orice tip de date JSON valid, inclusiv:
Șir
Număr
Boolean (adevărat sau fals)
Matrice (care conține orice alt tip JSON valid)
Dicționar (care conține orice alt tip JSON valid)
Nul
Nedefinit
În culise, aplicația Scurtături codează și decodează automat valoarea dvs. returnată pentru a comunica între JavaScript și aplicația Scurtături. Acest lucru înseamnă că dvs. nu trebuie să apelați JSON.stringify(result) înainte de apelarea gestionarului de finalizare.
Deoarece valoarea returnată este JSON, anumite valori returnate nu vor funcționa bine. De exemplu, o funcție sau Nod nu va avea o reprezentare codată JSON utilă. În acest caz, vă recomandăm să creați o Matrice/Dicționar care conține valorile compatibile cu JSON de care aveți nevoie.
Notă: Deoarece un obiect în JavaScript este pur și simplu un dicționar, obiectele simple se convertesc bine la JSON.
Dacă nu doriți să returnați date din acțiunea “Executare JavaScript pe pagina web”, puteți apela completion() fără niciun argument în funcție (deoarece undefined este o ieșire validă). Aceasta este identică apelării completion(undefined).
Pentru informații suplimentare despre JSON, consultați Introducere în utilizarea JSON în Scurtături pe iPhone sau iPad.
Pentru mai multe informații despre noduri, consultați https://developer.mozilla.org/ro/Node.
Pentru mai multe informații despre funcții, consultați https://developer.mozilla.org/ro/Functions.
Limita de timp a acțiunii “Executare JavaScript pe pagina web”
Asemenea tuturor extensiilor JavaScript din Safari, acțiunea “Executare JavaScript pe pagina web” este supusă unei limite de timp și trebuie finalizată cât mai rapid posibil. Este posibil ca scripturile JavaScript care utilizează funcții sincronizate să nu se finalizeze la timp, inclusiv:
window.alert()window.prompt()window.confirm()Timpii de expirare care durează mai multe secunde - de exemplu:
window.setTimeout(function() { completion(); }, 5000);
Dacă scriptul JavaScript depășește limita de timp, scurtătura nu se va finaliza și va apărea un mesaj de eroare Expirare JavaScript atunci când executați scurtătura.
Manipularea erorilor de sintaxă și runtime
Puteți utiliza orice sintaxă compatibilă cu Safari pentru a scrie JavaScript în acțiunea “Executare JavaScript pe pagina web”.
În aplicația Scurtături, acțiunea “Executare JavaScript pe pagina web” vă ajută să depistați erorile prin efectuarea unei verificări elementare a sintaxei înainte de a executa scurtătura din extensia Safari.
Pe măsură ce introduceți scriptul în câmpul de text, evidențierea sintaxei asigură validitatea JavaScript. De exemplu, dacă uitați să includeți ghilimele la capătul unui șir, este evidențiat tot textul ce urmează după respectivul șir.
Dacă sintaxa scriptului dvs. este validă, dar conține o eroare runtime, acțiunea “Executare JavaScript pe pagina web” depistează și afișează excepțiile. De exemplu, dacă scriptul face referire la o variabilă sau o funcție care nu există (cum ar fi shortcuts.completion()), se afișează o eroare la momentul executării.