TypeScript Academy · Pelajaran

Inferens Jenis Berasaskan Lokempat

Pastikan semua lokempat berkongsi struktur kunci yang sama.

Pelajaran 4 daripada 413 langkah

Inferens Jenis Berasaskan Lokempat ialah pelajaran TypeScript Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran TypeScript Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus TypeScript Academy merangkumi sejumlah 4 pelajaran.

Inferens Jenis Mengikut Lokal

Sebuah aplikasi menyokong beberapa locales (en, tr, de...). Kami mahukan jenis yang menghasilkan ralat apabila mana-mana lokal tiada kunci yang terdapat dalam asas, supaya terjemahan tidak terkeluar daripada penyelarasan secara senyap.

Lokal Asas

Pilih satu lokal (biasanya en) sebagai struktur kunci piawai. Setiap lokal lain mesti sepadan dengan bentuknya.

const en = {
  greeting: "Hello",
  cart: { empty: "Empty", checkout: "Checkout" },
} as const;

type Base = typeof en;

Mengehadkan Lokal Lain

Berikan jenis kepada setiap lokal tambahan berdasarkan bentuk asas. Kunci yang hilang kini menjadi ralat kompilasi dalam fail lokal tersebut.

const tr: Base = {
  greeting: "Merhaba",
  cart: { empty: "Bo\u015f", checkout: "\u00d6deme" },
};
// Omitting cart.checkout -> Error: property missing

Mengesan Kunci Tambahan Juga

Menggunakan jenis asas sebagai anotasi turut menandakan kunci tidak diketahui yang wujud dalam sesuatu lokal tetapi tiada dalam asas, sekali gus mengesan entri yang tertinggal atau tersalah eja.

const de: Base = {
  greeting: "Hallo",
  cart: { empty: "Leer", checkout: "Kasse" },
  extra: "oops", // Error: not in Base
};

Pembantu untuk Mentakrifkan Lokal

Pembantu generik menguatkuasakan bentuk tersebut sambil mengekalkan setiap nilai, lalu menyediakan tempat definisi yang kemas bagi setiap lokal.

function defineLocale<T extends Base>(loc: T): T {
  return loc;
}

const fr = defineLocale({
  greeting: "Bonjour",
  cart: { empty: "Vide", checkout: "Paiement" },
});

Daftar Semua Lokal

Kumpulkan locales dalam satu rekod. Mengehadkan setiap nilai kepada Base menjamin struktur yang seragam di seluruh aplikasi.

const locales: Record<string, Base> = { en, tr, de: fr };
// every entry must have the full Base key structure

Kesamaan Peringkat Jenis (Mendalam)

Untuk jaminan yang lebih ketat, anda boleh membina jenis SameKeys yang membandingkan struktur kunci secara mendalam dan menghasilkan jenis ralat apabila strukturnya berbeza, melampaui perkara yang dapat dikesan oleh anotasi biasa.

type SameKeys<A, B> =
  keyof A extends keyof B
    ? keyof B extends keyof A ? true : false
    : false;

Menerbitkan Kunci Sekali Sahaja

Oleh sebab semua locales berkongsi Base, jenis laluan kunci (daripada pelajaran terdahulu) dikira sekali daripada Base dan digunakan semula untuk setiap lokal, jadi penaipan t tidak bergantung pada lokal.

type Key = LeafPaths<Base>;
// same valid keys regardless of active locale

Pemilihan Lokal semasa Masa Jalan

Semasa masa jalan, anda mengindeks daftar menggunakan lokal yang aktif; sistem jenis sudah menjamin bahawa setiap lokal mempunyai kunci yang sama, jadi carian adalah selamat.

function translate(locale: keyof typeof locales, key: Key): string {
  return getPath(locales[locale], key);
}

Mengesan Kunci yang Hilang Merentas Lokal

Jika anda tidak dapat memberikan anotasi kepada setiap fail secara langsung (contohnya, import JSON), pemeriksaan jenis semasa binaan membandingkan setiap lokal yang diimport dengan Base dan memaparkan jenis perbezaan yang menyenaraikan kunci yang hilang.

type Missing<L> = Exclude<keyof Base, keyof L>;
type TrMissing = Missing<typeof tr>; // never if complete

Mengapa Ini Penting

i18n tanpa jenis mudah tersasar: kunci yang ditambahkan pada en terlupa ditambahkan pada de, lalu aplikasi menghantar rentetan kosong atau bahasa Inggeris. Mengehadkan setiap lokal kepada asas yang dikongsi menukarkan kecuaian itu menjadi ralat kompilasi, sekali gus memastikan semua lokal lengkap dan konsisten.

Semakan Pantas

Sahkan pemahaman anda tentang inferens mengikut lokal.

Jawab dalam pelajaran interaktif

Imbas Kembali

Anda memilih lokal asas sebagai bentuk piawai dan mengehadkan setiap lokal lain kepadanya, jadi kunci yang hilang atau berlebihan menyebabkan kompilasi gagal. Pembantu defineLocale dan daftar yang dihadkan memastikan semua lokal mempunyai struktur yang sama, manakala laluan kunci diterbitkan sekali daripada asas.

Percuma untuk bermula

Pelajari TypeScript dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 101
Pelajaran: 352

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Inferens Jenis Berasaskan Lokempat” percuma?

Ya — teks penuh “Inferens Jenis Berasaskan Lokempat” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus TypeScript Academy, tingkat taraf kepada CoddyKit PRO. Kursus TypeScript Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Inferens Jenis Berasaskan Lokempat”?

Pastikan semua lokempat berkongsi struktur kunci yang sama. Anda berlatih TypeScript Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan TypeScript Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran TypeScript Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Inferens Jenis Berasaskan Lokempat” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran TypeScript Academy ini?

Ya. Setiap pelajaran TypeScript Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke TypeScript Academy