Encadenamiento opcional de TypeScript

El encadenamiento opcional (Optional Chaining) es una forma segura de acceso a propiedades en TypeScript y JavaScript.

Permite a los desarrolladores acceder de forma segura a propiedades de objetos anidados mediante llamadas en cadena. Cuando cualquier propiedad en la ruta de acceso es null o undefined, toda la expresión devuelve undefined mediante cortocircuito, sin lanzar un error.

Esto simplifica enormemente el código de acceso a propiedades de objetos profundamente anidados.


Diagrama SVG: funcionamiento del encadenamiento opcional Fondo Título Funcionamiento del encadenamiento opcional Izquierda: método tradicional Método tradicional (extenso) // Requiere múltiples comprobaciones var city = user && user.address && user.address.city; Propenso a errores, código redundante Flecha Simplificación Derecha: método con encadenamiento opcional Método con encadenamiento opcional (conciso) // Todo en una línea var city = user ?.address ?.city; Seguro y conciso, cortocircuito automático Sección inferior: tres usos Tres formas del encadenamiento opcional Uso 1 obj?.prop — acceso a propiedades Uso 2 arr?. Uso 3 obj?.method() — invocación de métodos Marcador de flecha

Por qué se necesita el encadenamiento opcional

En el desarrollo con JavaScript/TypeScript, a menudo es necesario acceder a propiedades de objetos profundamente anidadas.

La forma tradicional requiere comprobar capa por capa si la propiedad existe. Este enfoque no solo hace que el código sea extenso, sino que también es fácil omitir comprobaciones y provocar errores en tiempo de ejecución.

Explicación del concepto:El núcleo del encadenamiento opcional es la "evaluación de cortocircuito". Cuando el valor de una propiedad en la cadena es null o undefined, el resultado de toda la expresión devuelve inmediatamente undefined, sin continuar accediendo a las propiedades posteriores.


Sintaxis básica

Usar?.el operador para acceder de forma segura a propiedades que podrían no existir.

En comparación con la comprobación en cadena tradicional con &&, la sintaxis del encadenamiento opcional es más concisa e intuitiva.

Ejemplo

// Define un objeto de usuario anidado
// Contiene nombre e información de dirección; la dirección tiene ciudad
var user = {
    name: "EJEMPLO",
    address: {
        city: "Beijing"
    }
};

// Método tradicional: usar && para comprobar capa por capa
// Este método es extenso y propenso a omisiones
var city1 = user && user.address && user.address.city;

// Método con encadenamiento opcional: usar el operador ?.
// Si cualquier capa es null o undefined, devuelve directamente undefined
var city2 = user?.address?.city;

console.log("Método tradicional: " + city1);
console.log("Encadenamiento opcional: " + city2);

Resultado de ejecución:

传统方式: Beijing
可选链: Beijing

Sugerencia:Cuando las propiedades del objeto existen, ambos métodos producen el mismo resultado. Sin embargo, el código con encadenamiento opcional es más conciso y fácil de leer.


Manejo de propiedades inexistentes

Cuando una propiedad en la ruta de acceso no existe, el encadenamiento opcional devuelve undefined de forma segura, sin lanzar un error.

Esto es especialmente útil para manejar datos provenientes de APIs o entradas de formularios de usuario.

Ejemplo

// Define un objeto de usuario incompleto
// Solo tiene la propiedad name, no tiene la propiedad address
var user = {
    name: "EJEMPLO"
    // La propiedad address no existe
};

// Usa encadenamiento opcional para acceder a propiedades anidadas
// user.address es undefined, por lo tanto city también es undefined
var city = user?.address?.city;

// Accede a una propiedad anidada más profunda
// Incluso si country no existe, sigue devolviendo undefined sin errores
var country = user?.address?.country?.name;

console.log("Ciudad: " + city);
console.log("País: " + country);

Resultado de ejecución:

Ciudad: undefined
国家: undefined

Nota:El encadenamiento opcional solo devuelve undefined al acceder a una propiedad; no crea nuevos objetos ni propiedades.


Encadenamiento opcional con arrays

El encadenamiento opcional se puede combinar con el acceso por índice de arrays para acceder de forma segura a los elementos del array.

Usar?.[index]la sintaxis para devolver undefined cuando el elemento del array no existe.

no existe (el array solo tiene 2 elementos), devuelve undefined

// Define un array de usuarios
var users = [
    { name: "Alice" },
    { name: "Bob" }
];

// Accede de forma segura al nombre del primer elemento del array
// users?.
var firstUser = users?.[0]?.name;

// Accede de forma segura a un elemento inexistente del array
// users?.
var tenthUser = users?.[9]?.name;

console.log("Primer usuario: " + firstUser);
console.log("Décimo usuario: " + tenthUser);

Resultado de ejecución:

第一个用户: Alice
第十个用户: undefined

Explicación:?.[index]y?.La diferencia es que el primero se usa para arrays, y el segundo para propiedades de objetos.


Encadenamiento opcional con llamadas a métodos

El encadenamiento opcional se puede utilizar para invocar de forma segura métodos que podrían no existir.

Usar?.()la sintaxis para que, si el método no existe, se devuelva undefined sin lanzar un error.

Ejemplo

// Define un objeto de usuario con nombre y método greet
var user = {
    name: "Alice",
    // Define un método para saludar
    greet: function() {
        return "Hello, " + this.name;
    }
};

// Invoca de forma segura un método existente
// user.greet existe, se invoca normalmente y devuelve el resultado
var message1 = user.greet?.();

// Invoca de forma segura un método inexistente
// user.sayHello no existe, devuelve undefined sin errores
var message2 = user.sayHello?.();

console.log("greet: " + message1);
console.log("sayHello: " + message2);

Resultado de ejecución:

greet: Hello, Alice
sayHello: undefined

Casos de uso:Esto es especialmente útil al manejar funciones callback opcionales o controladores de eventos.


Asignación con encadenamiento opcional

El encadenamiento opcional también se puede usar en operaciones de asignación, pero hay que tener en cuenta su comportamiento.

La asignación con encadenamiento opcional solo modifica rutas existentes; no crea objetos intermedios automáticamente.

Ejemplo

// Define un objeto de usuario simple
var user = {
    name: "Alice"
};

// Intenta usar encadenamiento opcional en una asignación
// user?.address no existe, por lo que toda la asignación se omite
// El objeto user permanece sin cambios
user?.address?.city = "Beijing";

console.log("Usuario: " + JSON.stringify(user));

Resultado de ejecución:

Usuario: {"name":"Alice"}

Nota:La asignación con encadenamiento opcional no se puede usar para crear nuevas propiedades. Si necesitas crear objetos anidados, debes usar la forma tradicional creando primero los objetos intermedios.


Fusión nula y encadenamiento opcional

El encadenamiento opcional se usa a menudo junto con el operador de fusión nula??en combinación.

Esta combinación puede proporcionar un valor predeterminado cuando la propiedad no existe, lo que hace el código más robusto.

Ejemplo

// Define un objeto de usuario incompleto
var user = {
    name: "Alice"
    // address no existe
};

// Encadenamiento opcional + fusión nula: usa el valor predeterminado cuando city es null o undefined
var city = user?.address?.city ?? "Ciudad desconocida";

console.log("Ciudad: " + city);

// Comparación: la forma compleja del método tradicional
var country = user && user.address && user.address.country
    ? user.address.country
    : "País desconocido";

console.log("País: " + country);

Resultado de ejecución:

Ciudad: Ciudad desconocida
País: País desconocido

Explicación:??Solo se usa el valor predeterminado cuando el valor es null o undefined, mientras que||también se usa el valor predeterminado cuando el valor es falsy (0, '', false). Al manejar números o cadenas, se debe dar prioridad a??。


Precauciones

  • Evaluación de cortocircuito:El encadenamiento opcional devuelve inmediatamente al encontrar null o undefined; no continúa accediendo a las propiedades posteriores.
  • No se pueden crear propiedades:La asignación con encadenamiento opcional no crea objetos intermedios automáticamente.
  • Combinación con fusión nula:Se recomienda usar siempre??para proporcionar valores predeterminados, y usar menos||
  • Consideraciones de rendimiento:Aunque el encadenamiento opcional es más seguro, en los casos en que la propiedad ciertamente existe, el acceso directo tiene mejor rendimiento.

Recomendación:En el desarrollo real, para propiedades de datos externos (como respuestas de API o entradas de usuario), se debe priorizar el uso del encadenamiento opcional para realizar un acceso seguro.


Resumen

El encadenamiento opcional es una característica importante para manejar objetos anidados en JavaScript/TypeScript moderno.

  • ?.:Acceso seguro a propiedades de objetos
  • ?.[index]:Acceso seguro a elementos de arrays
  • ?.():Llamada segura a métodos que pueden no existir
  • ??:Proporcionar valores predeterminados, manejar casos de undefined

Mejores prácticas:Siempre usa el encadenamiento opcional para acceder a propiedades profundas que pueden no existir. Combinado con el operador de coalescencia nula, puedes escribir código seguro y conciso.

Otras extensiones