Reflect

Esta tradução está incompleta. Ajude a traduzir este artigo em inglês

Reflect é um objeto nativo que provê métodos para operações JavaScript interceptáveis. Os métodos são os mesmos que o dos manipuladores de Proxy. Reflect não é um objeto de função, então não é construtível.

Descrição

Ao contrário da maioria dos objetos globais, Reflect não é um construtor. Você não pode usá-lo com o operador new ou invocar o objeto Reflect como uma função. Todas as propriedades e métodos do Reflect são estáticos (igual o objeto Math).

O objeto Reflect provê as seguintes funções estáticas as quais tem os mesmos nomes usados pelos métodos manipuladores de Proxy.

Alguns deste métodos são também os mesmos correspondentes aos métodos em Object, embora eles tenham diferenças sutis entre eles.

Métodos

Reflect.apply(targetthisArgumentargumentsList)
Chama uma função de destino com os argumentos, conforme especificado pelo parâmetro argumentsList. Veja também Function.prototype.apply().
Reflect.construct(targetargumentsList[, newTarget])
 O operador new como uma função. Equivalente a chamada new target(...args). Também possui a opção de especificar um prototype diferente
Reflect.defineProperty(targetpropertyKeyattributes)
Similar ao Object.defineProperty(). Retorna um Boolean com o valor true se a propriedade foi definida com sucesso.
Reflect.deleteProperty(targetpropertyKey)
O operador delete como uma função. Equivalente a chamada delete target[name].
Reflect.get(), "Reflect.get(targetpropertyKey[, receiver])"}}
Uma função que retorna o valor da propriedade. Funciona como obter uma propriedade de um objeto (target[propertyKey]) como uma função.
Reflect.getOwnPropertyDescriptor(targetpropertyKey)
Similar ao Object.getOwnPropertyDescriptor(). Retorna um descritor de propriedade da propriedade dada se existir no objeto, undefined caso contrário.
Reflect.getPrototypeOf(target)
Igual ao Object.getPrototypeOf().
Reflect.has(target, propertyKey)
O operador in como função. Retorna um Boolean indicando se existe uma propriedade própria ou herdada.
Reflect.isExtensible(target)
Igual ao Object.isExtensible(). Returna um Boolean com o valor true se o destino (parâmetro target) for extensível.
Reflect.ownKeys(target)
Retorna uma matriz das chaves de propriedade do próprio objeto de destino (não herdadas).
Reflect.preventExtensions(target)
Similar ao Object.preventExtensions(). Retorna um Boolean com o valor true se a atualização foi bem sucedida.
Reflect.set(targetpropertyKeyvalue[, receiver])
Uma função que atribui valores a propriedades. Retorna um Boolean com o valor true se a atualização foi bem sucedida.
Reflect.setPrototypeOf(targetprototype)
Uma função que define o protótipo de um objeto. Retorna um Boolean com o valor true se a atualização foi bem sucedida.

Exemplos

Verificando se um objeto contém determinadas propriedades

const duck = {
  name: 'Maurice',
  color: 'white',
  greeting: function() {
    console.log(`Quaaaack! My name is ${this.name}`);
  }
}

Reflect.has(duck, 'color');
// true
Reflect.has(duck, 'haircut');
// false

Retornando as próprias chaves do objeto

Reflect.ownKeys(duck);
// [ "name", "color", "greeting" ]

Adicionando uma nova propriedade ao objeto

Reflect.set(duck, 'eyes', 'black');
// returns "true" if successful
// "duck" now contains the property "eyes: 'black'"

Especificações

Especificação Situação Comentário
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Reflect' in that specification.
Padrão Definição Inicial
ECMAScript (ECMA-262)
The definition of 'Reflect' in that specification.
Padrão em tempo real Reflect.enumerate foi removido.

Compatibilidade do navegador

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!
Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 49.0 (Yes) 42 (42) Não suportado Não suportado Não suportado
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 49.0 49.0 42.0 (42) Não suportado Não suportado Não suportado

Veja também