CKTIS / JavaScript
FocusEvent.relatedTarget — el otro objetivo de la transición de foco
FocusEvent.relatedTarget identifica el otro objeto implicado en una transición de foco: el objetivo anterior al recibir el foco o el siguiente al perderlo. La propiedad es de solo lectura y puede ser null.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent representa los eventos focus, blur, focusin y focusout. Hereda de UIEvent e indirectamente de Event. Su propiedad FocusEvent.relatedTarget describe el otro objetivo de una transición de foco, no el objetivo identificado por event.target.
En focus y focusin, event.target identifica el objeto que recibe el foco, mientras que event.relatedTarget identifica el objeto que lo pierde. En blur y focusout, los papeles se invierten: event.target pierde el foco y event.relatedTarget lo recibe.
relatedTarget es de solo lectura y devuelve un EventTarget o null. El otro objetivo puede no estar disponible o quedar oculto por motivos de seguridad, por ejemplo, al tabular hacia una página o salir de ella. Comprueba si es null antes de usar el valor; tampoco des por hecho que todo EventTarget es un elemento DOM.
El constructor new FocusEvent(type, options) permite establecer relatedTarget; su valor predeterminado es null. El ejemplo comprueba esta opción sin depender de la interacción del usuario. FocusEvent es una API web del navegador, no una característica de una edición concreta de ECMAScript. MDN indica que la interfaz y la propiedad están ampliamente disponibles desde julio de 2015; usar Node 24 en un repositorio no demuestra que esta API sea compatible.
Ejemplos
(() => {
const previous = document.createElement("button");
previous.id = "previous";
const event = new FocusEvent("focus", {
relatedTarget: previous
});
console.log(event.type);
console.log(event.relatedTarget === previous);
console.log(new FocusEvent("blur").relatedTarget === null);
})();Resultado
focus true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.