TypeScript Academy · Pelajaran

Token Layanan yang Aman Secara Jenis

Gunakan token bertipe untuk menghindari error penyelesaian saat runtime.

Token Layanan yang Aman Secara Jenis adalah pelajaran TypeScript Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar TypeScript Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus TypeScript Academy mencakup 4 pelajaran total.

Masalah Token String

Token string seperti "Logger" mudah salah ketik dan tidak membawa informasi tipe. Kontainer tidak dapat memberi tahu Anda bahwa get("Loggr") salah, dan tipe hasil resolusinya sering kali berupa any.

Simbol sebagai Token

Menggunakan simbol, bukan string, memberi setiap token identitas unik yang tidak dapat bertabrakan dengan token lain secara tidak sengaja. Registri terpusat membuatnya tetap teratur.

const TYPES = {
  Logger: Symbol.for("Logger"),
  Mailer: Symbol.for("Mailer"),
} as const;

Memetakan Token ke Tipe

Tujuan yang lebih mendalam adalah mengaitkan setiap token dengan tipe yang dihasilkannya, sehingga kontainer mengembalikan tipe yang benar, bukan any. Kita membuat pembungkus token bertipe.

interface Token<T> {
  readonly id: symbol;
  readonly _type?: T; // phantom type marker
}

Membuat Token Bertipe

Sebuah pembantu menghasilkan token yang mengingat tipenya dalam bidang semu. Bidang tersebut tidak pernah menyimpan nilai; bidang itu hanya membawa informasi tipe untuk kompiler.

function token<T>(name: string): Token<T> {
  return { id: Symbol.for(name) };
}
const LoggerToken = token<Logger>("Logger");

Antarmuka Kontainer Bertipe

Kita memberikan tipe pada kontainer agar get dapat menyimpulkan tipe hasil resolusi dari token. Tanpa pemaksaan tipe dan tanpa any.

interface TypedContainer {
  get<T>(t: Token<T>): T;
  bind<T>(t: Token<T>, impl: () => T): void;
}

Binding dengan Tipe yang Disimpulkan

Saat Anda melakukan bind, tipe hasil yang dikembalikan pabrik harus sesuai dengan tipe token. Ketidaksesuaian akan ditemukan saat kompilasi.

declare const c: TypedContainer;
c.bind(LoggerToken, () => new ConsoleLogger());
// ConsoleLogger must satisfy Logger or this errors.

Resolusi dengan Tipe Lengkap

Sekarang get mengembalikan tepat tipe token tersebut. Pelengkapan otomatis dan pemeriksaan tipe dapat bekerja pada hasilnya tanpa anotasi manual.

const logger = c.get(LoggerToken); // type: Logger
logger.log("typed resolution");

Menghindari Kesalahan Pencarian

Karena token adalah nilai bertipe, salah ketik akan merujuk ke variabel yang tidak didefinisikan (galat kompilasi), bukan string yang salah secara diam-diam. Seluruh kategori galat yang disebabkan oleh kunci string pun hilang.

// c.get(LogerToken) -> compile error: LogerToken is not defined

Padanan InversifyJS

InversifyJS juga mendukung token simbol, dan pembantu dari komunitas menyediakan pembungkus bertipe. Prinsipnya sama: lakukan bind token bertipe ke implementasi, lalu selesaikan dengan tipe yang tepat.

import { Container } from "inversify";
const TYPES = { Logger: Symbol.for("Logger") };
// container.bind<Logger>(TYPES.Logger).to(ConsoleLogger)

Registri Token

Memusatkan token dalam satu modul memberikan satu sumber kebenaran, sehingga token mudah ditemukan, diubah, dan dijaga konsistensinya di seluruh basis kode.

export const TOKENS = {
  Logger: token<Logger>("Logger"),
  Mailer: token<Mailer>("Mailer"),
};

Ringkasan Manfaat

Token bertipe memberikan identitas unik (simbol), keamanan saat kompilasi (ketidaksesuaian ditolak), tipe hasil resolusi yang benar (tanpa any), dan perlindungan dari salah ketik (galat variabel yang tidak didefinisikan).

Pemeriksaan Singkat

Pemeriksaan singkat tentang pelajaran ini.

Ringkasan

Token layanan yang aman terhadap tipe membungkus symbol unik dengan tipe semu, yang memetakan setiap token ke tipe hasil resolusinya. get mengembalikan tipe yang tepat, binding mewajibkan implementasi yang sesuai, dan salah ketik menjadi galat kompilasi, bukan galat pencarian string yang terjadi secara diam-diam.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Token Layanan yang Aman Secara Jenis” gratis?

Ya — teks lengkap “Token Layanan yang Aman Secara Jenis” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus TypeScript Academy, upgrade ke CoddyKit PRO. Kursus TypeScript Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Token Layanan yang Aman Secara Jenis”?

Gunakan token bertipe untuk menghindari error penyelesaian saat runtime. Kamu berlatih TypeScript Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai TypeScript Academy?

Tidak diperlukan pengalaman sebelumnya. TypeScript Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Token Layanan yang Aman Secara Jenis” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran TypeScript Academy ini?

Ya. Setiap pelajaran TypeScript Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke TypeScript Academy