Introducción a la acción Ejecutar JavaScript en página web en Atajos en la Mac
Casi todas las páginas web tienen scripts que usan JavaScript, un lenguaje de programación que crea efectos dinámicos en los navegadores web, incluyendo animaciones, menús interactivos, reproducción de videos y más. Generalmente, JavaScript no está expuesto a ti cuando ves un sitio web. Sin embargo, al crear un atajo que contiene la acción Ejecutar JavaScript en página web y luego ejecutarlo desde la app Safari, puedes controlar el JavaScript de un sitio web.
Los atajos que ejecutan tu JavaScript personalizado en una página web tienen miles de usos. Por ejemplo, puedes crear atajos que obtienen datos específicos de un sitio web y luego los incorporan en una tarea, como extraer el horario de una clase y luego agregarlo a la app Calendario, o exportar los datos de los miembros de un grupo de redes sociales y luego agregarlos a una hoja de cálculo.
También puedes crear atajos que te permitan modificar una página web, como cambiar la fuente del texto de la página web, o modificar la velocidad de reproducción de un video. Para poder ejecutar JavaScript desde un atajo, debes activar la configuración. Consulta Configuración avanzada de privacidad y seguridad en Atajos en la Mac.
Para obtener más información sobre el uso de atajos que ejecutan JavaScript en una página web, consulta Usar la acción Ejecutar JavaScript en página web en Atajos en la Mac.
Acerca de cómo obtener los datos de la página web
La acción Ejecutar JavaScript en página web te permite obtener datos de una página web al tomar todos los elementos que cumplan con ciertos criterios, y luego iterarlos para realizar una tarea con ellos (o para inspeccionarlos más).
Por ejemplo, para crear una lista de todas las imágenes de una página web, utiliza:
var elements = document.querySelectorAll("img");
En otro ejemplo, para obtener todos los elementos con la clase “post”, utiliza:
var elements = document.querySelectorAll(".post");
Una vez que creas una NodeList, puedes iterar los elementos (para filtrarlos más o agregarlos a una estructura de datos) usando algo como:
var elements = ...;for (let element of elements) { // ...}Para obtener más información sobre la solicitud de resultados de páginas web, consulta https://developer.mozilla.org/Selectors y https://developer.mozilla.org/SelectorAll.
Entrada de la acción Ejecutar JavaScript en página web
La entrada de la acción Ejecutar JavaScript en página web debe ser una página web activa de Safari, lo que significa que debes ejecutar el atajo desde la hoja de compartir (específicamente desde Safari, SFSafariViewController, o ASWebAuthenticationSession).
Cuando se ejecuta un atajo desde la hoja de compartir, la entrada de la app Safari pasa a la primera acción de tu atajo.
Aunque la entrada en la acción Ejecutar JavaScript en un sitio web debe ser una página web de Safari, puedes insertar datos adicionales en la acción mediante Variables mágicas. Por ejemplo, el atajo Cambiar velocidad de video (disponible en la galería) contiene una acción Ejecutar JavaScript en página web que modifica un video en un sitio web. La variable Velocidad controla la velocidad de reproducción.
Para obtener información sobre cómo ejecutar atajos desde Safari, consulta Ejecutar un atajo al trabajar en la Mac.
Resultado de Ejecutar JavaScript en página web
Para devolver datos, debes invocar el administrador de acciones completadas en JavaScript, por ejemplo completion(result). Dado que JavaScript se usa generalmente con patrones asíncronos, la llamada es intencionalmente asíncrona. De esta forma, puedes terminar la acción de manera asíncrona. Por ejemplo, lo siguiente es válido:
window.setTimeout(function() { completion(true);}, 1000);El resultado de la acción Ejecutar JavaScript en página web es cualquier tipo de dato JSON válido, que incluye:
cadena
número
boolean (true o false);
arreglo (que contiene cualquier otro tipo JSON válido)
diccionario (que contiene cualquier otro tipo JSON válido);
nulo
sin definir
Tras bambalinas, Atajos automáticamente codifica y decodifica tu valor devuelto para establecer la comunicación entre JavaScript y la app Atajos. Esto significa que no tienes que invocar JSON.stringify(result) antes de invocar al administrador de tareas completadas.
Como el valor devuelto es JSON, ciertos valores devueltos no funcionarán bien. Por ejemplo, una función o nodo no tendrá una representación codificada con JSON útil. En este caso, se recomienda crear un arreglo o diccionario que contenga los valores JSON compatibles que necesitas.
Nota: debido a que un objeto en JavaScript es simplemente un diccionario, los objetos básicos se convierten correctamente a JSON.
Si no quieres devolver datos de la acción Ejecutar JavaScript en página web, puedes llamar a completion() sin un argumento en la función (porque undefined es una salida válida). Esto es igual que llamar a completion(undefined).
Para obtener más información acerca de JSON, consulta Introducción al uso de JSON en Atajos en la Mac.
Para obtener más información sobre las interfaces Node, consulta https://developer.mozilla.org/es/docs/Web/API/Node.
Para obtener más información sobre las funciones, consulta https://developer.mozilla.org/Functions.
Límite de tiempo de la acción Ejecutar JavaScript en página web
Como todas las extensiones de JavaScript en Safari, la acción Ejecutar JavaScript en página web está sujeta a un límite de tiempo y debería completarse lo más rápido posible. Las acciones JavaScript que usan funciones sincrónicas podrían no completarse dentro del límite de tiempo, tales como:
window.alert()window.prompt()window.confirm()Hace una cuenta regresiva de los últimos segundos, por ejemplo:
window.setTimeout(function() { completion(); }, 5000);
Si tu JavaScript supera el límite de tiempo, el atajo no se completará y aparecerá un mensaje de error de finalización de JavaScript al ejecutar el atajo.
Manejo de errores de sintaxis y de ejecución
Puedes usar cualquier sintaxis compatible en Safari para escribir JavaScript en la acción Ejecutar JavaScript en página web.
En la app Atajos, la acción Ejecutar JavaScript en página web te ayuda a detectar errores al realizar revisiones de sintaxis básicas antes de ejecutar el atajo desde la extensión de Safari.
Al ingresar tu script en el campo de texto, el resaltado de sintaxis te ayuda a cerciorarte de que tu JavaScript sea válido. Por ejemplo, si olvidas incluir las comillas al final de una cadena, se resalta todo el texto que está después de esa cadena.
Si la sintaxis de tu script es válida, pero contiene un error de ejecución, la acción Ejecutar JavaScript en página web identifica y muestra las excepciones. Por ejemplo, si tu script hace referencia a una variable o función que no existe (como shortcuts.completion()), se muestra un error al ejecutarse.