JavaScript Academy · Lekcja

Symbole jako klucze obiektów

Proszę używać symboli dla właściwości bez kolizji nazw.

Symbole jako klucze obiektów to bezpłatna lekcja JavaScript Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej JavaScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs JavaScript Academy zawiera 4 lekcji w sumie.

Symbole jako klucze

Symbol może być używany jako klucz właściwości obiektu. Ponieważ każdy symbol jest unikatowy, taka właściwość nie może przypadkowo kolidować z żadnym kluczem będącym ciągiem znaków.

const id = Symbol("id")
const user = {}
user[id] = 123
console.log(user[id])

Obliczane klucze symboli

Aby użyć symbolu jako klucza w literałowym zapisie obiektu, należy ująć go w nawiasy kwadratowe jako obliczaną nazwę właściwości.

const id = Symbol("id")
const user = {
  name: "Ann",
  [id]: 99
}
console.log(user[id])

Odczytywanie właściwości symbolu

Aby odczytać tę właściwość, trzeba mieć odwołanie do tego samego symbolu. Bez tego odwołania wartość jest praktycznie ukryta.

const secret = Symbol("secret")
const obj = { [secret]: "hidden" }
console.log(obj[secret])

Nie są wyliczane w for-in

Pętla for-in pomija klucze będące symbolami. Dzięki temu właściwości symboli nie pojawiają się podczas zwykłego iterowania.

const tag = Symbol("tag")
const obj = { a: 1, b: 2, [tag]: 3 }
for (const key in obj) {
  console.log(key)
}

Pomijane przez Object.keys

Object.keys zwraca wyłącznie klucze będące ciągami znaków, dlatego właściwości z kluczami symboli również są pomijane.

const tag = Symbol("tag")
const obj = { a: 1, [tag]: 2 }
console.log(Object.keys(obj))

Ukryte przed JSON

JSON.stringify całkowicie ignoruje klucze będące symbolami, dlatego nigdy nie pojawiają się one w serializowanym wyniku. Dzięki temu symbole dobrze nadają się do przechowywania wewnętrznych metadanych.

const meta = Symbol("meta")
const obj = { name: "Bo", [meta]: "internal" }
console.log(JSON.stringify(obj))

Znajdowanie kluczy symboli

Aby wyświetlić klucze symboli, należy użyć Object.getOwnPropertySymbols, które zwraca tablicę symboli będących właściwościami obiektu.

const tag = Symbol("tag")
const obj = { a: 1, [tag]: 2 }
const syms = Object.getOwnPropertySymbols(obj)
console.log(syms.length)

Unikanie konfliktów nazw

Klucze symboli pozwalają różnym bibliotekom dodawać właściwości do tego samego obiektu bez ryzyka wzajemnego nadpisywania, ponieważ ich symbole są różne.

const libA = Symbol("data")
const libB = Symbol("data")
const shared = {}
shared[libA] = 1
shared[libB] = 2
console.log(shared[libA], shared[libB])

Klucze symboli a operator spread

Operator spread dla obiektów kopiuje klucze symboli, w przeciwieństwie do for-in i Object.keys, dlatego podczas klonowania należy pamiętać, że zostaną one również przeniesione.

const tag = Symbol("tag")
const src = { a: 1, [tag]: 2 }
const copy = { ...src }
console.log(copy[tag])

Przechowywanie danych przypominających prywatne

Klucze symboli zapewniają pewną formę prywatności: dane są dostępne tylko dla kodu posiadającego dany symbol, więc nie pojawiają się na zwykłych listach właściwości.

const balance = Symbol("balance")
function makeAccount() {
  const acct = {}
  acct[balance] = 100
  return { acct: acct, key: balance }
}
const a = makeAccount()
console.log(a.acct[a.key])

Usuwanie właściwości symboli

Właściwość symbolu usuwa się tak samo jak każdą inną, używając operatora delete wraz z odwołaniem do symbolu.

const tag = Symbol("tag")
const obj = { [tag]: 5 }
delete obj[tag]
console.log(obj[tag])

Szybki test

Sprawdź swoją wiedzę na temat kluczy symboli.

Podsumowanie

Podsumowanie: Symbole tworzą bezpieczne, ukryte klucze obiektów.

Używaj nawiasów kwadratowych dla obliczanych kluczy symboli
Są pomijane przez for-in, Object.keys i JSON
Można je wyświetlić za pomocą Object.getOwnPropertySymbols
Doskonale nadają się do metadanych bez konfliktów nazw

const k = Symbol("k")
const o = { [k]: 7 }
console.log(o[k])

Często zadawane pytania

Czy lekcja „Symbole jako klucze obiektów” jest bezpłatna?

Tak — pełny tekst „Symbole jako klucze obiektów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu JavaScript Academy, przejdź na CoddyKit PRO. Kurs JavaScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Symbole jako klucze obiektów”?

Proszę używać symboli dla właściwości bez kolizji nazw. Ćwiczysz JavaScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć JavaScript Academy?

Nie wymagamy żadnego doświadczenia. JavaScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Symbole jako klucze obiektów”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji JavaScript Academy?

Tak. Każda lekcja JavaScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do JavaScript Academy