Object.getOwnPropertySymbols()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
O Object.getOwnPropertySymbols() método retorna uma array com todas propriedades de símbolo encontradas diretamente em um determinado objeto dado.
Experimente
const object1 = {}; const a = Symbol("a"); const b = Symbol.for("b"); object1[a] = "localSymbol"; object1[b] = "globalSymbol"; const objectSymbols = Object.getOwnPropertySymbols(object1); console.log(objectSymbols.length); // Expected output: 2 Sintaxe
Object.getOwnPropertySymbols(obj); Parâmetro
objO objeto pelo qual as propriedades de símbolos são retornas.
Valor retornado
Uma array com todas as propriedades de símbolos encontradas diretamente pelo o objeto dado.
Descrição
Similar do Object.getOwnPropertyNames(), você pode obter todas as propriedades de símbolo de um objeto dado como um array de símbolos. Lembre que o próprio Object.getOwnPropertyNames() não contém as propriedades de símbolo de um objeto e somente as propriedades de string.
Como todos os objetos não possuem símbolos próprios inicialmente, o Object.getOwnPropertySymbols() retorna uma array vazia a menos que você tenha definido as propriedades de símbolo do seu objeto .
Exemplos
Usando getOwnPropertySymbols
var obj = {}; var a = Symbol("a"); var b = Symbol.for("b"); obj[a] = "localSymbol"; obj[b] = "globalSymbol"; var objectSymbols = Object.getOwnPropertySymbols(obj); console.log(objectSymbols.length); // retorno esperado 2 console.log(objectSymbols); // retorno esperado (2) [Symbol(a), Symbol(b)] console.log(objectSymbols[0]); // retorno esperado Symbol(a) Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.getownpropertysymbols |
