Esta página describe la gramática léxica de JavaScript. El texto fuente de los scripts de ECMAScript se escanea de izquierda a derecha y se convierte en una secuencia de elementos de entrada que son segmentos, caracteres de control, terminadores de línea, comentarios oEspacio en blanco. ECMAScript también define ciertas palabras clave y literales y tiene reglas para la inserción automática del punto y coma en las declaraciones finales.

Caracteres de control

Los caracteres de control no tienen representación visual, pero se utilizan para controlar la interpretación del texto.

Espacio en blanco

Los caracteres deEspacio_en_blanco mejoran la legibilidad del texto fuente y separan los fragmentos entre sí. Estos caracteres suelen ser innecesarios para la funcionalidad del código. Lasherramientas de minificación se utilizan a menudo para eliminar espacios en blanco con el fin de reducir la cantidad de datos que se deben transferir.

Terminadores de línea

Además de los caracteres deespacio en blanco, los caracteres de terminación de línea se utilizan para mejorar la legibilidad del texto fuente. Sin embargo, en algunos casos, los terminadores de línea pueden influir en la ejecución del código JavaScript, ya que hay algunos lugares donde están prohibidos. Los terminadores de línea también afectan el proceso de lainserción automática de punto y coma. Los terminadores de línea se corresponden con la clase\s enexpresiones regulares.

Solo los siguientes puntos de código Unicode se tratan como terminadores de línea en ECMAScript, otros caracteres de salto de línea se tratan como espacios en blanco (por ejemplo,Next Line,NEL,U+0085 se consideran como espacios en blanco).

Comentarios

Los comentarios se utilizan para agregar consejos, notas, sugerencias o advertencias al código JavaScript. Esto puede facilitar su lectura y comprensión. También se pueden utilizar para deshabilitar el código y evitar que se ejecute; esta puede ser una valiosa herramienta de depuración.

JavaScript tiene dos formas antiguas de agregar comentarios al código.

La primera forma son las dobles barras inclinadas// comentario**;** esta convierte en comentario todo el texto que le sigue en la misma línea. Por ejemplo:

function comment() {  // Este es un comentario JavaScript de una línea  console.log("¡Hola mundo!");}comment();

La segunda forma es el estilo/* */, que es mucho más flexible.

Por ejemplo, lo puedes usar en una sola línea:

function comment() {  /* Este es un comentario JavaScript de una línea */  console.log("¡Hola mundo!");}comment();

También puedes hacer comentarios de varias líneas, como este:

function comment() {  /* Este comentario abarca varias líneas. Aviso     No necesitamos cerrar el comentario hasta que terminemos. */  console.log("¡Hola mundo!");}comment();

También lo puedes usar en medio de una línea, si lo deseas, aunque esto puede hacer que tu código sea más difícil de leer, por lo que se debe usar con precaución:

function comment(x) {  console.log("¡Hola" + x /* inserta el valor de x */ + " !");}comment("mundo");

Además, lo puedes usar para deshabilitar el código y evitar que se ejecute, envolviendo el código en un comentario, como este:

function comment() {  /* console.log('¡Hola mundo!'); */}comment();

En este caso, la llamada aconsole.log() nunca se emite, debido a que está dentro de un comentario. De esta forma se puede desactivar cualquier número de líneas de código.

Comentarioshashbang

Una sintaxis de tercer comentario especializado, elcomentariohashbang, está en proceso de estandarización en ECMAScript (consulta laPropuesta de gramáticaHashbang).

Un comentariohashbang se comporta exactamente como un comentario de una sola línea (//). En cambio, comienza con#! ysolo son válidos al comienzo absoluto de un script o módulo. También ten en cuenta que no se permiten espacios en blanco de ningún tipo antes del#!. El comentario consta de todos los caracteres después de#! hasta el final de la primera línea; sólo se permite uno de esos comentarios.

El comentariohashbang especifica la ruta a un intérprete de JavaScript específico que deseas utilizar para ejecutar el script. Aquí tienes un sencillo ejemplo:

#!/usr/bin/env nodeconsole.log("Hola mundo");

¡Solo debes usar el estilo de comentario#! para especificar un intérprete de JavaScript. En todos los demás casos, utiliza un comentario// (o un comentario multilínea).

Palabras clave

Palabras clave reservadas a partir de ECMAScript 2015

• break
• case
• catch
• class
• const
• continue
• debugger
• default
• delete
• do
• else
• export
• extends
• finally
• for
• function
• if
• import
• in
• instanceof
• new
• return
• super
• switch
• this
• throw
• try
• typeof
• var
• void
• while
• with
• yield

Futuras palabras clave reservadas

Las siguientes están reservadas como palabras clave futuras por la especificación ECMAScript. No tienen ninguna funcionalidad especial en la actualidad, pero es posible que lo hagan en el futuro, por lo que no se pueden utilizar como identificadores.

Estas siempre están reservadas:

• enum

Las siguientes solo están reservadas cuando se encuentran en código de modo estricto:

• implements
• interface
• let
• package
• private
• protected
• public
• static
• yield

Las siguientes solo están reservadas cuando se encuentran en código de módulo:

• await

Futuras palabras clave reservadas en estándares más antiguos

Las siguientes están reservadas como palabras clave futuras según las especificaciones de ECMAScript anteriores (ECMAScript 1 a 3).

• abstract
• boolean
• byte
• char
• double
• final
• float
• goto
• int
• long
• native
• short
• synchronized
• throws
• transient
• volatile

Además, los literalesnull,true yfalse no se pueden utilizar como identificadores en ECMAScript.

Uso de palabras reservadas

Las palabras reservadas en realidad solo se aplican a losidentificadores (frente a losnombres de identificadores). Como se describe enes5.github.com/#A.1, todos estos sonIdentifierNames que no excluyenPalabras reservadas.

a.importa['import']a = { import: 'test' }.

Por otro lado, lo siguiente es ilegal porque es unIdentificador, que es unIdentifierName sin palabras reservadas. Los identificadores se utilizan paraFunctionDeclaration,FunctionExpression,VariableDeclaration y así sucesivamente. LosIdentifierNames se utilizan paraMemberExpression,CallExpression y así sucesivamente.

function import() {} // Ilegal.

Identificadores con significado especial

Algunos identificadores tienen un significado especial en algunos contextos sin ser palabras clave de ningún tipo. Estos incluyen:

• arguments
• get
• set

Literales

null literal

Consulta tambiénnull para obtener más información.

null;

Booleanos literales

Consulta tambiénBooleano para obtener más información.

true;false;

Literales numéricos

Los tiposNumber yBigInt usan literales numéricos.

Decimal

1234567890;42;// Precaución al usar con un cero a la izquierda:0888; // 888 procesado como decimal0777; // procesado como octal, 511 en decimal

Ten en cuenta que los decimales literales pueden comenzar con un cero (0) seguido de otro dígito decimal, pero si todos los dígitos después del0 inicial son menores que 8, el número se interpreta como un número octal. Esto no arrojará JavaScript, consultaerror 957513. Consulta también la página sobreparseInt()

Exponencial

El literal exponencial decimal se especifica mediante el siguiente formato:beN; dondeb es un número base (entero o flotante), seguido del caractere (que sirve como separador oindicador de exponente) yN, que es un númeroexponente opotencia: un entero con signo (según las especificaciones ECMA-262 de 2019):

0e-5; // => 00e5; // => 05e1; // => 50175e-2; // => 1.751e3; // => 10001e-3; // => 0.001

Binario

La sintaxis de números binarios utiliza un cero inicial seguido de una letra "B" latina en minúscula o mayúscula (0b o0B). Debido a que esta sintaxis es nueva en ECMAScript 2015, consulta la tabla de compatibilidad del navegador a continuación. Si los dígitos después de0b no son 0 o 1, se muestra el siguienteSyntaxError: "Faltan dígitos binarios después de 0b".

var FLT_SIGNBIT = 0b10000000000000000000000000000000; // 2147483648var FLT_EXPONENT = 0b01111111100000000000000000000000; // 2139095040var FLT_MANTISSA = 0b00000000011111111111111111111111; // 8388607

Octal

La sintaxis de números octales utiliza un cero inicial seguido de una letra "O" latina en minúscula o mayúscula (0o o0O). Debido a que esta sintaxis es nueva en ECMAScript 2015, consulta la tabla de compatibilidad del navegador a continuación. Si los dígitos después del0o están fuera del rango (01234567), se lanza el siguienteSyntaxError: "Dígitos octales faltantes después del 0o".

var n = 0o755; // 493var m = 0o644; // 420// También es posible con solo un cero inicial (ve la nota sobre los decimales arriba)0755;0644;

Hexadecimal

La sintaxis de números hexadecimales utiliza un cero inicial seguido de una letra "X" latina en minúscula o mayúscula (0x o0X). Si los dígitos después de 0x están fuera del rango (0123456789ABCDEF), se lanza el siguienteSyntaxError: "El identificador comienza inmediatamente después del literal numérico".

0xfffffffffffffffff; // 2951479051793528300000x123456789abcdef; // 819855292164869000xa; // 10

BigInt literal

El tipoBigInt es una primitiva numérica en JavaScript que puede representar números enteros con precisión arbitraria. Los BigInt literales se crean agregandon al final de un número entero.

123456789123456789n; // 1234567891234567890o777777777777n; // 687194767350x123456789abcdefn; // 819855292164868950b11101001010101010101n; // 955733

Ten en cuenta que los números octales heredados con solo un cero a la izquierda no funcionarán paraBigInt:

// 0755n// SyntaxError: sintaxis de BigInt no válida

Para númerosBigInt octales, siempre utiliza cero seguido de la letra "o" (mayúscula o minúscula):

0o755n;

Para obtener más información sobreBigInt, consulta tambiénestructuras de datos JavaScript.

Separadores numéricos

Para mejorar la legibilidad de literales numéricos, se pueden usar guiones bajos (_,U+005F) como separadores:

// separadores en números decimales1_000_000_000_000;1_050.95;// separadores en números binarios0b1010_0001_1000_0101;// separadores en números octales0o2_2_5_6;// separadores en números hexadecimales0xa0_b0_c0;// separadores en BigInts1_000_000_000_000_000_000_000n;

Ten en cuenta estas limitaciones:

 // No se permite más de un guión bajo en una fila100__000; // SyntaxError// No permitido al final de literales numéricos100_; // SyntaxError// No se puede usar después de 00_1; // SyntaxError

Objetos literales

Consulta tambiénObject eIniciador de objeto para obtener más información.

var o = { a: "foo", b: "bar", c: 42 };// notación abreviada. Nueva en ES2015var a = "foo",  b = "bar",  c = 42;var o = { a, b, c };// en vez devar o = { a: a, b: b, c: c };

Arreglos literales

Consulta tambiénArray para obtener más información.

[1954, 1974, 1990, 2014];

Cadenas literales

Una cadena literal es cero o más puntos de código Unicode entre comillas simples o dobles. Los puntos de código Unicode también se pueden representar mediante una secuencia de escape. Literalmente todos los puntos de código pueden aparecer en una cadena literal, excepto estos puntos de código de cierre de cita:

• U+005C \ (backslash),
• U+000D <CR>,
• y U+000A <LF>.

Antes de lapropuesta para hacer que todo el texto JSON sea ECMA-262 válido, U+2028 <LS> y U+2029 <PS>, tampoco se permitió que aparecieran sin escape en las cadenas literales.

Cualquier punto de código puede aparecer en forma de secuencia de escape. Las cadenas literales se evalúan como valores de cadena de ECMAScript. Al generar estos valores de cadena, los puntos de código Unicode están codificados en UTF-16.

'foo';"bar";

Secuencias de escape hexadecimales

Las secuencias de escape hexadecimales constan de\x seguido de exactamente dos dígitos hexadecimales que representan una unidad de código o un punto de código en el rango de 0x0000 a 0x00FF.

"\xA9"; // "©"

Secuencias de escape Unicode

Una secuencia de escape Unicode consta exactamente de cuatro dígitos hexadecimales después de\u. Representa una unidad de código en la codificación UTF-16. Para los puntos de código U+0000 a U+FFFF, la unidad de código es igual al punto de código. Los puntos de código U+10000 a U+10FFFF requieren dos secuencias de escape que representan las dos unidades de código (un par sustituto) utilizadas para codificar el carácter; el par sustituto es distinto del punto de código.

Consulta tambiénString.fromCharCode() yString.prototype.charCodeAt().

"\u00A9"; // "©" (U+A9)

Puntos de escape de código Unicode

Un punto de código de escape Unicode consta de\u{, seguido de un punto de código en base hexadecimal, seguido de}. El valor de los dígitos hexadecimales debe estar en el rango 0 y 0x10FFFF inclusive. Los puntos de código en el rango U+10000 a U+10FFFF no necesitan representarse como un par sustituto. Se agregaron puntos de código de escape a JavaScript en ECMAScript 2015 (ES6).

Consulta tambiénString.fromCodePoint() yString.prototype.codePointAt().

"\u{2F804}"; // CJK COMPATIBILIDAD IDEOGRÁFICA-2F804 (U+2F804)// el mismo caracter representado como un par suplente"\uD87E\uDC04";

Expresión regular literal

Consulta tambiénRegExp para obtener más información.

/ab+c/g// Una expresión regular literal "vacía"// El grupo de no captura vacío es necesario// para evitar la ambigüedad con comentarios de una sola línea./(?:)/

Plantillas literales

Consulta tambiéncadenas de plantilla para obtener más información.

`string text``string text line 1 string text line 2``string text ${expression} string text`tag`string text ${expression} string text`

Inserción automática de punto y coma

Algunasdeclaraciones JavaScript se deben terminar con punto y coma y, por lo tanto, se ven afectadas por la inserción automática del punto y coma (IAPC):

• Declaración vacía
• let,const, declaración de variable
• import,export, declaración de módulo
• Declaración de expresión
• debugger
• continue,break,throw
• return

La especificación ECMAScript mencionatres reglas de inserción de punto y coma.

1. Se inserta un punto y coma antes, cuando se encuentra unterminador de línea o "}" que no está permitido por la gramática.

{ 1 2 } 3// La IAPC lo transforma en{ 1 2 ;} 3;

2. Se inserta un punto y coma al final, cuando se detecta el final del flujo de entrada de símbolos y el analizador no puede procesar el único flujo de entrada como un programa completo.

Aquí++ no se trata como unoperador sufijo que se aplica a la variableb, porque se produce un terminador de línea entreb y++.

a = b;++c;// IAPC lo transforma ena = b;++c;

3. Se inserta un punto y coma al final, cuando una declaración con producción restringida en la gramática va seguida de un terminador de línea. Estas declaraciones con reglas "no LineTerminator aquí" son:

• PostfixExpressions (++ y--)
• continue
• break
• return
• yield,yield*
• module

return;a + b;// La IAPC lo transforma enreturn;a + b;

Especificaciones

Compatibilidad con navegadores

Ve también

• Jeff Walden: números binarios y octales
• Mathias Bynens: caracteres de secuencias de escape JavaScript
• Booleanos
• Números
• RegExp
• Cadenas de texto (Strings)