Object
O construtor Object
cria um wrapper de objeto.
Sintaxe
// Object initialiser or literal { [ nameValuePair1[, nameValuePair2[, ...nameValuePairN] ] ] } // Called as a constructor new Object([value])
Parametros
nameValuePair1, nameValuePair2, ... nameValuePairN
-
Pares de nomes (strings) e valores (qualquer valor) em que o nome é separado do valor por dois pontos.
value
-
Qualquer valor.
Descrição
O construtor Object
cria um wrapper de objeto para o valor fornecido. Se o valor for null
ou undefined
, ele criará e retornará um objeto vazio, caso contrário, retornará um objeto de um Type que corresponde ao dado valor. Se o valor já for um objeto, ele retornará o valor.
Quando chamado em um contexto não-construtor, o object
se comporta de forma idêntica ao new Object ()
.
Veja também object initializer / literal syntax.
Propriedades do construtor Object
Object.length
-
Tem um valor de 1.
Object.prototype
-
Permite a adição de propriedades a todos os objetos do tipo Object.
Métodos do construtor Object
Object.assign()
-
Copia os valores de todas as propriedades próprias enumeráveis de um ou mais objetos de origem para um objeto de destino.
Object.create()
-
Cria um novo objeto com o objeto e as propriedades do protótipo especificado.
Object.defineProperty()
-
Adiciona a propriedade nomeada descrita por um determinado descritor a um objeto.
Object.defineProperties()
-
Adiciona as propriedades nomeadas descritas pelos descritores fornecidos a um objeto.
Object.entries()
-
Retorna uma matriz contendo todos os pares
[key, value]
das próprias propriedades de string enumeráveis de um determinado objeto. Object.freeze()
-
Congela um objeto: outro código não pode excluir ou alterar nenhuma propriedade.
Object.fromEntries()
-
Retorna um novo objeto de um iterável de pares de valor-chave (reverso à
Object.entries
). Object.getOwnPropertyDescriptor()
-
Retorna um descritor de propriedade para uma propriedade nomeada em um objeto.
Object.getOwnPropertyDescriptors()
-
Retorna um objeto contendo todos os descritores de propriedade para um objeto.
Object.getOwnPropertyNames()
-
Retorna uma matriz contendo os nomes de todas as propriedades enumeráveis e não enumeráveis do próprio objeto fornecido.
Object.getOwnPropertySymbols()
-
Retorna uma matriz de todas as propriedades de símbolo encontradas diretamente sobre um determinado objeto.
Object.getPrototypeOf()
-
Retorna o protótipo do objeto especificado.
Object.is()
-
Compara se dois valores são o mesmo valor. Equivale a todos os valores de
NaN
(que diferem da Comparação de Igualdade Abstrata e da Comparação de Igualdade Estrita). Object.isExtensible()
-
Determina se a extensão de um objeto é permitida.
Object.isFrozen()
-
Determina se um objeto foi congelado.
Object.isSealed()
-
Determina se um objeto está selado.
Object.keys()
-
Retorna uma matriz contendo os nomes de todas as propriedades de string enumeráveis do objeto fornecido.
Object.preventExtensions()
-
Impede qualquer extensão de um objeto.
Object.seal()
-
Impede que outro código exclua propriedades de um objeto.
Object.setPrototypeOf()
-
Define o protótipo (isto é, a propriedade interna
[[Prototype]]
). Object.values()
-
Retorna uma matriz contendo os valores que correspondem a todas as propriedades de string enumeráveis do próprio objeto.
Instâncias de Object
e Object
de protótipo de objeto
Todos os objetos em JavaScript são descendentes do Object
; todos os objetos herdam métodos e propriedades de Object.prototype
, embora eles possam ser substituídos. Por exemplo, protótipos de outros construtores substituem a propriedade constructor
e fornecer seus próprios métodos toString()
. As alterações no objeto de protótipo Object
são propagadas para todos os objetos, a menos que as propriedades e os métodos sujeitos a essas alterações sejam substituídos na cadeia de protótipos.
Propriedades (enUS)
Métodos (enUS)
Excluindo uma propriedade de um objeto
Não há nenhum método em um Objeto para excluir suas próprias propriedades (por exemplo, como Map.prototype.delete()
). Para isso, é necessário usar o operador delete.
Exemplos
Usando Object
com tipos undefined
e null
Os exemplos a seguir armazenam um Object
vazio na variável "o
":
var o = new Object();
var o = new Object(undefined);
var o = new Object(null);
Using Object
to create Boolean
objects
Os exemplos a seguir armazenam objetos Boolean
na variável "o
":
// equivalent to o = new Boolean(true);
var o = new Object(true);
// equivalent to o = new Boolean(false);
var o = new Object(Boolean());
Especificações
Specification |
---|
ECMAScript Language Specification # sec-object-objects |
Compatibilidade
BCD tables only load in the browser