TypeScript Academy · Pelajaran

Pelapisan Konfigurasi dan Nilai Bawaan

Gabungkan nilai bawaan, file, dan penggantian dari lingkungan.

Pelapisan Konfigurasi dan Nilai Bawaan adalah pelajaran TypeScript Academy gratis di CoddyKit. Ini adalah pelajaran 3 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.

Konfigurasi Berlapis

Aplikasi nyata menyusun config dari beberapa sumber: defaults bawaan, berkas config, dan penggantian oleh lingkungan. Lapisan yang lebih akhir menggantikan lapisan sebelumnya berdasarkan urutan prioritas yang ditentukan.

Urutan Prioritas

Urutan yang umum, dari prioritas terendah ke tertinggi: defaults < config berkas < variabel lingkungan. Penggantian oleh lingkungan menjadi prioritas tertinggi karena sesuai untuk penyesuaian tiap penerapan.

Mendefinisikan Lapisan

Setiap lapisan adalah config parsial. Hanya defaults dasar yang harus lengkap; lapisan lainnya mengisi atau menggantikan bidang tertentu.

interface Config { port: number; host: string; logLevel: string; }
const defaults: Config = { port: 3000, host: "localhost", logLevel: "info" };

Penggantian Parsial

Lapisan berkas dan env bertipe Partial<Config> karena keduanya mungkin hanya menentukan sebagian kunci. Mengetikkannya sebagai parsial mencerminkan bahwa bidang apa pun dapat tidak ada.

const fileConfig: Partial<Config> = { port: 8080 };
const envConfig: Partial<Config> = { logLevel: "debug" };

Penggabungan Dangkal

Untuk config datar, penggabungan dengan sintaks sebar menerapkan prioritas dengan rapi. Objek yang lebih akhir menggantikan kunci sebelumnya dan menghasilkan config akhir.

const config: Config = { ...defaults, ...fileConfig, ...envConfig };
// { port: 8080, host: "localhost", logLevel: "debug" }

Mengapa Urutan Penting

Karena sintaks sebar yang ditulis belakangan menang, sumber yang dicantumkan terakhir memiliki prioritas tertinggi. Susun ulang sintaks sebar dan Anda mengubah lapisan mana yang menggantikan lapisan lainnya.

Config Bersarang Memerlukan Penggabungan Mendalam

Penggabungan dangkal menggantikan seluruh objek bersarang. Jika config memiliki bagian bersarang, Anda memerlukan penggabungan mendalam yang menggabungkannya secara rekursif, bukan menimpanya.

interface Config { db: { host: string; port: number }; }
// { ...a, ...b } would replace the entire db object, losing keys.

Penggabungan Mendalam Bertipe

Penggabungan rekursif menelusuri kedua objek, masuk ke rekaman bersarang dan menggantikan nilai daun. Pengetikan hasilnya memerlukan pembantu tipe rekursif.

type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> };
function deepMerge<T>(base: T, over: DeepPartial<T>): T {
  const out: any = { ...base };
  for (const k in over) {
    const v = (over as any)[k];
    out[k] = v && typeof v === "object" ? deepMerge((base as any)[k], v) : v;
  }
  return out;
}

DeepPartial untuk Lapisan Penggantian

Lapisan penggantian diberi tipe DeepPartial<Config> agar dapat menentukan subset kunci bersarang apa pun, dengan tetap diperiksa tipenya terhadap bentuk lengkap.

const override: DeepPartial<Config> = { db: { port: 5433 } };
// merges into db without dropping db.host

Menggabungkan dengan Validasi

Gabungkan terlebih dahulu, lalu validasi hasilnya dengan skema. Dengan begitu, config akhir yang telah sepenuhnya diselesaikan menjadi objek yang diperiksa kebenarannya.

// const merged = deepMerge(defaults, override);
// const config = ConfigSchema.parse(merged);

Praktik Terbaik untuk Pelapisan

Jaga defaults agar lengkap dan aman, gunakan berkas untuk menyatakan pengaturan khusus lingkungan, dan simpan variabel env untuk rahasia serta penggantian per penerapan di bagian teratas rantai prioritas.

Pemeriksaan Singkat

Pemeriksaan singkat tentang pelajaran ini.

Ringkasan

Config berlapis menggabungkan defaults, config berkas, dan penggantian env berdasarkan urutan prioritas (defaults < berkas < env). Config datar menggunakan sintaks sebar; config bersarang memerlukan penggabungan mendalam yang diberi tipe dengan DeepPartial<Config>. Validasi hasil penggabungan tersebut.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Pelapisan Konfigurasi dan Nilai Bawaan” gratis?

Ya — teks lengkap “Pelapisan Konfigurasi dan Nilai Bawaan” 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 “Pelapisan Konfigurasi dan Nilai Bawaan”?

Gabungkan nilai bawaan, file, dan penggantian dari lingkungan. 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 3 dari 4.

Berapa lama pelajaran “Pelapisan Konfigurasi dan Nilai Bawaan” 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