CKTIS / JavaScript
FocusEvent.relatedTarget — o outro alvo da transição de foco
FocusEvent.relatedTarget identifica o outro objeto envolvido numa transição de foco: o alvo anterior ao receber o foco ou o alvo seguinte ao perdê-lo. A propriedade é só de leitura e pode ser null.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent representa os eventos focus, blur, focusin e focusout. Herda de UIEvent e, indiretamente, de Event. A propriedade FocusEvent.relatedTarget descreve o outro alvo de uma transição de foco, não o alvo identificado por event.target.
Em focus e focusin, event.target identifica o objeto que recebe o foco, enquanto event.relatedTarget identifica o objeto que o perde. Em blur e focusout, os papéis invertem-se: event.target perde o foco e event.relatedTarget recebe-o.
relatedTarget é só de leitura e devolve um EventTarget ou null. O outro alvo pode estar indisponível ou oculto por motivos de segurança, por exemplo, ao usar a tecla Tab para entrar ou sair de uma página. Verifique se o valor é null antes de o utilizar; também não assuma que todo o EventTarget é um elemento DOM.
O construtor new FocusEvent(type, options) permite definir relatedTarget; o valor predefinido é null. O exemplo verifica esta opção sem depender da interação do utilizador. FocusEvent é uma Web API do browser, não uma funcionalidade de uma edição específica de ECMAScript. A MDN indica que a interface e a propriedade estão amplamente disponíveis desde julho de 2015; utilizar Node 24 num repositório não comprova o suporte desta API.
Exemplos
(() => {
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.