Apakah itu route guard?

Question

Accepted Answer

**Route guard** adalah fungsi yang mengawal **sama ada navigasi ke/dari rute dibenarkan**. Mereka berjalan sebelum rute diaktifkan (atau sebelum anda meninggalkannya), membolehkan pemeriksaan autentikasi, kawalan kebenaran, dan petunjuk "perubahan tidak disimpan". ## Jenis-jenis guard ```text CanActivate → can the user enter this route? (auth/permission check) CanActivateChild → same, for child routes CanDeactivate → can the user LEAVE? ("you have unsaved changes") CanMatch → should this route even be matched? (feature flags, role-based) resolve → pre-fetch data BEFORE the route activates ``` ## Guard CanActivate berfungsi (Angular moden) ```ts import { CanActivateFn, Router } from "@angular/router"; import { inject } from "@angular/core"; export const authGuard: CanActivateFn = (route, state) => { const auth = inject(AuthService); const router = inject(Router); if (auth.isLoggedIn()) { return true; // allow navigation } return router.createUrlTree(["/login"]); // redirect to login }; ``` Guard mengembalikan `true` (benarkan), `false` (blok), atau `UrlTree` (alih hala). Angular moden menggunakan **guard berfungsi** (fungsi biasa dengan `inject()`) daripada yang lebih lama berbasis kelas. ## Menggunakan guard pada rute ```ts export const routes: Routes = [ { path: "dashboard", component: DashboardComponent, canActivate: [authGuard], // protect this route }, { path: "admin", component: AdminComponent, canMatch: [roleGuard], // only match for admins }, ]; ``` ## CanDeactivate — mencegah kehilangan data yang tidak disengajakan ```ts export const unsavedChangesGuard: CanDeactivateFn = (component) => { if (component.form.dirty) { return confirm("You have unsaved changes. Leave anyway?"); } return true; }; ``` Guard klasik ini memberi amaran kepada pengguna sebelum menavigasi jauh dari borang dengan pengeditan yang tidak disimpan. ## Guard boleh menjadi async ```ts export const authGuard: CanActivateFn = () => inject(AuthService).checkSession().pipe(map(ok => ok || router.createUrlTree(["/login"]))); // guards can return Observable or Promise ``` ## Mengapa ia penting Guard adalah cara standard, terpusat untuk menguatkuasakan kawalan akses dan peraturan navigasi di Angular — melindungi rute yang disahkan, pintu gerbang mengikut peranan/kebenaran, mencegah kehilangan data semasa keluar, dan pra-memuatkan data (resolver). Meletakkan semakan ini dalam guard (daripada tersebar dalam komponen) memastikan logik keselamatan dan navigasi konsisten dan deklaratif; `authGuard` pada rute yang dilindungi adalah sesuatu yang hampir setiap aplikasi Angular sebenar melaksanakan.