HOWTO · JavaScript
Enumerador en JavaScript
En la publicación de hoy, aprenderemos sobre el enumerador en JavaScript.
En esta página
JavaScript no tiene un tipo tradicional integrado de Enum. En JavaScript sin extensiones, puedes usar un array ordenado cuando importa la posición o crear un objeto que asocie nombres con valores numéricos. Para buscar en un array, indexOf(searchElement) busca un valor coincidente. TypeScript sí ofrece sintaxis para enumeraciones, pero estos patrones de JavaScript usan arrays y objetos comunes que se comportan de forma distinta.
Qué representa una enumeración en JavaScript
Una enumeración asigna nombres significativos a un conjunto fijo de valores relacionados. En JavaScript, ni un array ni un objeto adquieren automáticamente las reglas de una enumeración: ambos son valores mutables comunes. Elige una representación según cómo necesite tu código acceder a los valores. Un array resulta práctico cuando importa el orden o quieres encontrar la posición de un valor. Un objeto resulta práctico cuando ya tienes un nombre y necesitas obtener el número asociado.
Usa un array cuando necesites valores ordenados y búsqueda
Un array conserva el orden en que se escriben sus valores. Su método indexOf devuelve la primera posición coincidente o -1 si no encuentra ninguna coincidencia. Compara mediante igualdad estricta, por lo que los valores de tipos distintos no coinciden. Si un valor aparece más de una vez, devuelve la primera aparición.
El argumento opcional fromIndex indica dónde empieza la búsqueda. Un valor no negativo inicia la búsqueda en esa posición; uno negativo cuenta desde el final del array. Si la posición inicial resultante queda después del último elemento, no se encuentra nada. Si una posición inicial negativa queda antes del comienzo, la búsqueda empieza en el primer elemento. Para más detalles, consulta la referencia de indexOf.
Ejecuta este ejemplo. El bloque y sus etiquetas visibles se mantienen en inglés.
const operatingSystems = ['Linux', 'macOS', 'Windows', 'Ubuntu'];
console.log(operatingSystems.indexOf('Linux'));
El número devuelto es la posición, basada en cero, del primer valor coincidente. Al procesar una búsqueda, comprueba si el resultado es -1 antes de tratarlo como una posición válida. Los arrays también son mutables: .push() puede añadir un valor, mientras que .map() crea un array nuevo a partir de valores transformados. Esos métodos no convierten el array en una enumeración ni imponen un conjunto fijo de valores. Los enlaces se conservan porque el inventario no proporciona destinos existentes en español.
Crea un objeto similar a una enumeración con un bucle
Si el código necesita buscar un número por nombre, un bucle puede crear un objeto cuyos nombres de propiedad procedan de una lista de argumentos y cuyos valores sean sus posiciones. Esta función usa arguments, la colección local de una función tradicional que contiene los argumentos recibidos. Aquí, Enum es el nombre de una función definida por el usuario, no una palabra clave de JavaScript ni un tipo integrado.
Ejecuta este ejemplo. El bloque y sus etiquetas visibles se mantienen en inglés.
function Enum() {
const values = {};
for (let i = 0; i < arguments.length; i++) {
values[arguments[i]] = i;
}
return values;
}
const operatingSystem = Enum('Linux', 'macOS', 'Windows', 'Ubuntu');
console.log(operatingSystem.Linux);
La propiedad Linux está asociada al valor 0 porque es el primer argumento. Esta versión devuelve un objeto común, así que puedes usarlo directamente sin new. Si se repite el nombre de un argumento, la asignación posterior reemplaza el valor anterior de esa propiedad. Como este objeto hereda de Object.prototype, este patrón sencillo es más adecuado para una lista controlada de nombres comunes. Si los nombres pueden proceder de una entrada arbitraria o no confiable, usa un objeto sin prototipo o un Map. La asociación funciona en una sola dirección: no añade una búsqueda inversa del número a su nombre ni valida los valores asignados en otras partes del programa.
Elige un patrón y ten en cuenta sus límites
Usa un array cuando el orden sea importante o necesites buscar valores con indexOf. Usa un objeto que asocie nombres con números cuando la entrada sea un nombre conocido y acceder directamente a una propiedad resulte más claro que buscar en un array. En ambos casos, JavaScript no garantiza que la colección permanezca fija, no impide los valores desconocidos ni asegura que las posiciones numéricas sigan siendo estables si reordenas las entradas.
Para un conjunto pequeño de constantes, agrupa los valores y, por convención, evita modificarlos después de inicializarlos. Si el código depende de valores numéricos persistidos, formatos de red o valores compartidos entre programas, asigna números explícitos y trátalos como parte de esa interfaz; derivarlos de las posiciones de un array puede cambiar silenciosamente su significado al reordenar las entradas. Las enumeraciones de TypeScript ofrecen sintaxis de enumeración en tiempo de compilación, pero son una característica de TypeScript y tienen su propio comportamiento en el JavaScript generado. Elígelas cuando el sistema de tipos de TypeScript forme parte de tu proyecto; no des por sentado que los arrays u objetos nativos de JavaScript ofrecen las mismas comprobaciones.