Diferencias de sintaxis entre motores de expresiones

Consulte este documento para obtener más información sobre cómo mejorar las expresiones del motor de expresiones de JavaScript, o bien para corregir los errores que se producen cuando las expresiones escritas para las versiones anteriores de After Effects no se evalúan en el motor de expresiones de JavaScript.

El lenguaje de expresión en After Effects se basa en JavaScript, que es una implementación de ECMAScript. El motor de expresiones de JavaScript en After Effects 16.0 se basa en ECMAScript 2018. El motor de expresiones de ExtendScript heredado se basa en ECMAScript 3 (1999). (Adobe ExtendScript es también el lenguaje utilizado para crear scripts en After Effects y en otras aplicaciones de Adobe).

Puede seguir los ejemplos que se ofrecen a continuación, así como las directrices para la creación de expresiones que funcionen en los motores de expresiones tanto de JavaScript como de ExtendScript heredado.

Las principales diferencias entre los motores de expresiones de JavaScript y ExtendScript heredado son las siguientes:

• Sintaxis JavaScript moderna: las adiciones realizadas en JavaScript desde ECMAScript 5 hasta ECMAScript 2018 permiten usar nuevos métodos y sintaxis en las expresiones al utilizar el motor de expresiones de JavaScript. Además, también se han realizado pequeñas mejoras en la sintaxis de las expresiones al utilizar el motor de expresiones de JavaScript. Estas son algunas de las diferencias principales:
  • Las expresiones pueden utilizar la sintaxis JavaScript de ECMAScript 2018.
  • .value ya no es necesario al realizar una vinculación a otras propiedades desde Source Text
  • Es posible congelar valores de propiedades con posterizeTime(0)
• Sintaxis heredada no compatible: determinada sintaxis heredada no es compatible con el motor de expresiones de JavaScript. Estas excepciones se documentan aquí, junto con los cambios necesarios para lograr que la sintaxis que no funciona sea compatible con el motor de JavaScript. Estas son algunas de las diferencias principales:
  • Diferencias en la sintaxis if...else
  • Los elementos if y else no pueden estar en la misma línea sin corchetes.
  • Las expresiones no pueden terminar en una declaración de función.
  • No se admite la sintaxis abreviada this(); debe utilizarse thisLayer()
  • El acceso del índice de matriz de la propiedad Source Text a los caracteres requiere .value
  • No se permiten las propiedades ni los métodos en formato Snake_case
  • Se permite el uso de eval() con expresiones con codificación binaria (.jsxbin)
  • La compatibilidad es limitada para el objeto $. (dólar).
  • No se admiten los elementos ...reflect.properties, ...reflect.methods ni toSource()
• Requisitos de sintaxis para las bibliotecas de expresiones .jsx y eval(): al utilizar expresiones dentro de una biblioteca de funciones de expresiones .jsx, o cuando se llama a una expresión dentro de eval(), thisLayer. y thisProperty. deben llamarse de forma explícita. Asimismo, las operaciones matemáticas en matrices se deben sustituir por operaciones matemáticas vectoriales. Estas son algunas de las diferencias principales:
  • Los métodos y atributos nativos deben incluir de forma explícita los prefijos thisLayer. o thisProperty.
  • Se reemplazan los operadores matemáticos por funciones vectoriales

Las expresiones pueden utilizar la sintaxis JavaScript de ECMAScript 2018.

Se han agregado muchos elementos al lenguaje JavaScript desde ECMAScript 3. Hay nuevos métodos, más compactos y legibles, para utilizar con cadenas, matrices y objetos. También hay nuevas formas de declarar variables y funciones, así como parámetros predeterminados, operadores de propagación y mucho más. En este documento no se tratan dichos cambios, ya que son generales del lenguaje JavaScript. En los siguientes vínculos encontrará recursos para obtener más información sobre dichas adiciones a la sintaxis:

• Guía de JavaScript ES5 (también conocido como ECMAScript 5)
  • Nuevos métodos de matrices
  • Nuevos métodos de objetos
  • JSON.stringify() y JSON.parse()

• Guía de JavaScript ES6 (también conocido como ECMAScript 2015)
  • let y const
  • Funciones de flecha
  • Operador de propagación

• Guía de ECMAScript 2016
  • Array.includes()
  • Operador de exponenciación

• Guía de ECMAScript 2017
  • Relleno de cadenas
  • Comas finales

• Guía de ECMAScript 2018
  • Propiedades Rest y Spread para objetos

Recursos adicionales recomendados en los que se trata JavaScript en profundidad:

• Documentos web JavaScript MDN de Mozilla
• Tutoriales JavaScript de w3schools

.value ya no es necesario al realizar una vinculación a otras propiedades desde Source Text.

Al hacer referencia a otro valor de propiedad desde una propiedad de Source Text, el motor de ExtendScript heredado requiere que se agregue .value al final de la propiedad. El motor de JavaScript muestra el valor de la propiedad de forma predeterminada, a no ser que se utilice explícitamente otro atributo como .propertyIndex o .name.

Por ejemplo:

Es posible congelar valores de propiedades con posterizeTime(0).

En After Effects 16.0, posterizeTime(0) permite congelar el valor de propiedad en el momento 0 en la composición. Se aplica tanto al motor de JavaScript como al motor de ExtendScript heredado.

La sintaxis heredada no es compatible.

Casi toda la sintaxis de las expresiones del motor de expresiones de ExtendScript heredado es compatible con el motor de expresiones de JavaScript. Sin embargo, cierta sintaxis heredada no es compatible con el motor de expresiones de JavaScript. En ocasiones, esto se debe a los cambios de sintaxis en el JavaScript moderno. En otros casos, se han retirado algunos elementos obsoletos o anticuados de la sintaxis. A continuación se ofrecen algunos ejemplos de la sintaxis, tanto de los elementos que funcionan como de los que no.

La mayor parte de estas diferencias en la sintaxis se puede corregir mediante la creación de scripts de aplicación que reescriban las expresiones.

Diferencias en la sintaxis if...else

En general, se recomienda escribir siempre las declaraciones if...else con saltos de línea y corchetes de acuerdo con las directrices de MDN. El motor de ExtendScript heredado toleraba la sintaxis de las declaraciones if...else, pero el motor de JavaScript es muy estricto. La sintaxis if...else incorrecta no se evalúa al utilizar el motor de JavaScript.

No se permite terminar una expresión en una declaración if sin un elemento else.

Si una expresión termina con una declaración if sin una declaración else, el motor de JavaScript no evaluará la expresión y arrojará el código de error “Undefined value used in expression (could be an out of range array subscript?)” (Se ha utilizado un valor sin definir en la expresión. ¿Puede ser un subscript de matriz fuera del intervalo?). En el motor ExtendScript heredado, la siguiente expresión se evalúa como 100, si el tiempo es superior a 1 segundo; en caso contrario, se evalúa como 50:

El motor de JavaScript necesita que la parte else de la declaración se establezca de forma explícita si es la última declaración de la expresión:

Este uso se evalúa correctamente tanto en el motor de JavaScript como en el motor de ExtendScript heredado.

Los elementos if y else no pueden estar en la misma línea sin corchetes.

Una declaración·if...else¬en·una·sola·línea·sin·corchetes·se·evalúa·en·el·motor·de·ExtendScript·heredado,·pero·no·lo·hace·en·el·motor·de·JavaScript,·donde·arroja·un·error·similar·a·“Syntax·Error:·Unexpected·token·else”·(Error·de·sintaxis:·token·else·inesperado)·o·“Undefined·value·used·in·expression·(could·be·an·out·of·range·array·subscript?)”·(Se ha utilizado un valor sin definir en la expresión. ¿Puede ser un subscript de matriz fuera del intervalo?). El error varía en función del contexto y el tipo de propiedad.

En el motor ExtendScript heredado, la siguiente expresión se evalúa como 100, si el tiempo es superior a 1 segundo; en caso contrario, se evalúa como 50:

El motor de JavaScript requiere saltos de línea o corchetes para evaluar las declaraciones if...else. Para casos sencillos, se puede utilizar el operador ternario. Con el motor de JavaScript se puede utilizar cualquiera de las siguientes sintaxis:

Todas las soluciones anteriores se evalúan correctamente tanto en el motor de JavaScript como en el motor de ExtendScript heredado.

Las expresiones no pueden terminar en una declaración de función.

Si una expresión termina con una declaración de función, el motor de JavaScript no evalúa la expresión y arroja el error “Object of type found where a Number, Array, or Property is needed” (Se ha encontrado un objeto de tipo, pero se necesitaba un número, una matriz o una propiedad). En el motor de JavaScript, el último elemento evaluado debe devolver un valor, en lugar de declararlo.

El ejemplo siguiente funciona en el motor heredado, pero no en el de JavaScript:

Si en la última línea se llama a una función (y no a una declaración), la expresión se evalúa correctamente en ambos motores:

No se admite la sintaxis abreviada this(); debe utilizarse thisLayer().

En el motor de ExtendScript heredado, this se permitía siempre como abreviatura de thisLayer.En el motor de JavaScript, this se refiere al objeto global y debe utilizarse thisLayer. Utilizar this en el motor de JavaScript suele tener como resultado el error “this is not a function” (Este elemento no es una función).

En el ejemplo de ExtendScript heredado siguiente, this se utiliza para crear un vínculo compacto con una propiedad Text Layer Position desde la propiedad Source Text:

En el motor de JavaScript, this debe sustituirse por thisLayer:

El uso de thisLayer es compatible con ambos motores de expresiones.

El acceso del índice de matriz de la propiedad Source Text a los caracteres requiere .value.

En el motor de expresiones de ExtendScript heredado, es posible acceder a los caracteres de una propiedad de texto mediante una notación de corchetes como una matriz:

En el motor de JavaScript, debe agregarse .value para acceder a los caracteres:

Esta sintaxis es compatible con ambos motores.

No se permiten las propiedades ni los métodos en formato Snake_case.

El motor de JavaScript no admite las propiedades y los métodos Snake_case obsoletos (escritos con un guion bajo y no en formato camelCase). Deben utilizarse las versiones en formato camelCase, pues estas son compatibles con ambos motores. A continuación se ofrece una lista de propiedades Snake_case obsoletas y su equivalente en camelCase.

Se permite el uso de eval() con expresiones con codificación binaria (.jsxbin).

El motor de JavaScript no admite las expresiones codificadas en el formato binario de ExtendScript (guardadas como un archivo binario .jsxbin desde ExtendScript ToolKit CC).

Si desea ofuscar una expresión, utilice el motor de ExtendScript heredado o use un método de ofuscación diferente que sea compatible con ECMAScript 2018. Algunos métodos de ofuscación pueden no ser compatibles con ambos motores de expresión.

La compatibilidad es limitada para el objeto $. (dólar).

Los métodos y las propiedades del objeto $. (dólar) son específicos de ExtendScript, y el motor de JavaScript no los admite en su mayoría. En esta tabla se muestran los usos compatibles y no compatibles del objeto $. (dólar):

No se admiten los elementos ...reflect.properties, ...reflect.methods ni toSource().

reflect.properties y reflect.methods no son compatibles con el motor de JavaScript. Se trata de métodos específicos de ExtendScript que no tienen equivalente directo en JavaScript.

toSource() se considera obsoleto en JavaScript y no es parte de ninguna pista estándar.

Para ver una lista de las propiedades y los métodos disponibles para cualquier propiedad de After Effects, como se ha hecho con los métodos anteriores, utilice la siguiente expresión en una propiedad Source Text y vincúlela a la propiedad de destino deseada. Por ejemplo, se puede utilizar el icono espiral en lugar de thisProperty en la línea 1:

La expresión anterior no es compatible con el motor de ExtendScript heredado. Utiliza sintaxis y métodos no disponibles en ECMAScript 3.

Requisitos de sintaxis para las bibliotecas de expresiones .jsx y eval() con el motor de JavaScript

Cuando se utilizan expresiones dentro de una biblioteca de funciones de expresiones .jsx, o cuando se llama a una expresión dentro de eval(), es preciso modificar ciertos elementos de la sintaxis:

Es preciso agregar un prefijo explícito thisLayer. o thisProperty. a cualquier método o atributo nativo al que no se llame explícitamente en una capa o propiedad. El prefijo indica al motor de JavaScript el objeto para el que se llama al método o atributo.

Las operaciones matemáticas realizadas sobre valores de matriz como Position deben calcularse utilizando la matemática vectorial, o bien funciones de bucle o iteración que actúen sobre todos los elementos de la matriz. Los operadores matemáticos sobrecargados, como position + [100,100], no se evaluarán.

Si se utiliza el motor de JavaScript, las expresiones de ExtendScript heredado se preprocesan antes de su evaluación para que la sintaxis de algunas de ellas sea legible para el nuevo motor. Sin embargo, estas tareas de preprocesamiento no se realizan al evaluar expresiones de una biblioteca de funciones de expresiones .jsx, o al llamar a una expresión dentro de eval(). En estos casos, las modificaciones de sintaxis indicadas deben realizarse de forma manual. Todas estas modificaciones de sintaxis son retrocompatibles con el motor ExtendScript heredado, de modo que una biblioteca de expresiones .jsx escrita para que funcione con el motor de JavaScript también funcionará con el motor ExtendScript heredado.

Sugerencia de rendimiento: Debido a la falta de preprocesamiento, las llamadas a expresiones complejas desde una biblioteca .jsx con la sintaxis y el motor de JavaScript pueden tener mejor rendimiento que las llamadas a las mismas expresiones directamente desde una propiedad.

Los métodos y atributos nativos deben incluir de forma explícita los prefijos thisLayer. o thisProperty.

En la tabla siguiente se enumeran los métodos y atributos que requieren un prefijo. Por ejemplo, time debe escribirse thisLayer.time, mientras que wiggle() debe escribirse thisProperty.wiggle(). 

Estos prefijos solo son necesarios en los casos en los que el atributo o método no recibe explícitamente una llamada en otra capa o propiedad. Por ejemplo, cuando se realiza la llamada thisComp.layer(1).hasParent, no es necesario agregar thisLayer. porque .hasParent ya está recibiendo explícitamente una llamada en layer(1).

Se reemplazan los operadores matemáticos por funciones vectoriales.

Tanto el motor de JavaScript como el de ExtendScript heredado permiten utilizar operadores matemáticos de sobrecarga en matrices empleando sintaxis como position + [100,100], aunque esto no funciona para las expresiones de una biblioteca de funciones de expresiones .jsx o dentro de eval().

Para realizar operaciones matemáticas en propiedades de matrices como Position, Scale, etc., se deben utilizar los equivalentes vectoriales para la suma, resta, multiplicación y división. Las funciones matemáticas vectoriales también sirven para números regulares, por lo que, en el caso de una propiedad que pueda utilizar ambos tipos de datos en una llamada, se debe emplear la función vectorial.

A continuación se ofrecen ejemplos de expresiones que utilizan operaciones estándar y operaciones vectoriales actualizadas. Las expresiones vectoriales también utilizan los prefijos thisLayer. o thisProperty. apropiados cuando es necesario.

Para encontrar la diferencia entre un wiggle() y el valor de una propiedad Position:

Para realizar una interpolación entre dos valores, de un modo similar a como se hace con linear(), pero con un rango que se extiende más allá de los valores mínimo y máximo definidos:

Para entrar y salir de un bucle de una propiedad Position: