Ngày tạo:2025-11-16Cập nhật lần cuối:2025-11-16

Tham chiếu tài liệu này tới trợ lý AI yêu thích của bạnChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

Đặt câu hỏi và nhận tóm tắt tài liệu bằng cách tham chiếu trang này và nhà cung cấp AI bạn chọn

Thêm MCP Server vào trợ lý AI của bạn

Bằng cách tích hợp Intlayer MCP Server vào trợ lý AI ưa thích của bạn, bạn có thể truy xuất toàn bộ tài liệu trực tiếp từ ChatGPT, DeepSeek, Cursor, VSCode, v.v.

Xem tài liệu MCP Server

Lịch sử phiên bản

Tài liệu ban đầu
v7.1.016/11/2025

Nội dung của trang này đã được dịch bằng AI.

Xem phiên bản mới nhất của nội dung gốc bằng tiếng Anh

Chỉnh sửa tài liệu này

Nếu bạn có ý tưởng để cải thiện tài liệu này, vui lòng đóng góp bằng cách gửi pull request trên GitHub.

Liên kết GitHub tới tài liệu

Sao chép

Sao chép Markdown của tài liệu vào bộ nhớ tạm

Tài liệu: Hàm getPrefix trong intlayer

Mô tả

Hàm getPrefix xác định tiền tố URL cho một locale nhất định dựa trên cấu hình chế độ định tuyến. Nó so sánh locale với locale mặc định và trả về một đối tượng chứa ba định dạng tiền tố khác nhau để xây dựng URL linh hoạt.

Tính năng chính:

Nhận một locale làm tham số đầu tiên (bắt buộc)
Đối tượng options tùy chọn với defaultLocale và mode
Trả về một đối tượng với các thuộc tính prefix và localePrefix
Hỗ trợ tất cả các chế độ định tuyến: prefix-no-default, prefix-all, no-prefix, và search-params
Công cụ nhẹ để xác định khi nào cần thêm tiền tố locale

Chữ ký hàm

getPrefix(  locale: Locales,               // Bắt buộc  options?: {                    // Tùy chọn    defaultLocale?: Locales;    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';  }): GetPrefixResulttype GetPrefixResult = {  prefix: string;   // ví dụ: 'fr/' hoặc ''  localePrefix?: Locale; // ví dụ: 'fr' hoặc undefined}

getPrefix(  locale: Locales,               // Bắt buộc  options?: {                    // Tùy chọn    defaultLocale?: Locales;    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';  }): GetPrefixResulttype GetPrefixResult = {  prefix: string;   // ví dụ: 'fr/' hoặc ''  localePrefix?: Locale; // ví dụ: 'fr' hoặc undefined}

Tham số

locale: Locales
- Mô tả: Locale để tạo tiền tố. Nếu giá trị là falsy (undefined, null, chuỗi rỗng), hàm sẽ trả về chuỗi rỗng.
- Kiểu: Locales
- Bắt buộc: Có
options?: object
- Mô tả: Đối tượng cấu hình để xác định tiền tố.
- Kiểu: object
- Bắt buộc: Không (Tùy chọn)
- options.defaultLocale?: Locales
  - Mô tả: Locale mặc định cho ứng dụng. Nếu không cung cấp, sẽ sử dụng locale mặc định được cấu hình trong cấu hình dự án của bạn.
  - Kiểu: Locales
  - Mặc định: Cấu hình dự án
- options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'
  - Mô tả: Chế độ định tuyến URL cho việc xử lý locale. Nếu không được cung cấp, sẽ sử dụng chế độ đã cấu hình trong cấu hình dự án của bạn.
  - Kiểu: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'
  - Mặc định: Cấu hình dự án
  - Chế độ:
    - prefix-no-default: Trả về chuỗi rỗng khi locale trùng với locale mặc định
    - prefix-all: Trả về tiền tố cho tất cả các locale bao gồm cả mặc định
    - no-prefix: Trả về chuỗi rỗng (không có tiền tố trong URL)
    - search-params: Trả về chuỗi rỗng (locale trong tham số truy vấn)

Trả về

Kiểu: GetPrefixResult
Mô tả: Một đối tượng chứa ba định dạng tiền tố khác nhau:
- prefix: Tiền tố đường dẫn có dấu gạch chéo ở cuối (ví dụ: 'fr/', '')
- localePrefix: Định danh locale không có dấu gạch chéo (ví dụ: 'fr', undefined)

Ví dụ sử dụng

Sử dụng cơ bản

import { getPrefix, Locales } from "intlayer";// Kiểm tra tiền tố cho locale tiếng AnhgetPrefix(Locales.ENGLISH, {  defaultLocale: Locales.ENGLISH,  mode: "prefix-all",});// Trả về: { prefix: 'en/', localePrefix: 'en' }// Kiểm tra tiền tố cho locale tiếng PhápgetPrefix(Locales.FRENCH, {  defaultLocale: Locales.ENGLISH,  mode: "prefix-no-default",});// Trả về: { prefix: 'fr/', localePrefix: 'fr' }

import { getPrefix, Locales } from "intlayer";// Kiểm tra tiền tố cho locale tiếng AnhgetPrefix(Locales.ENGLISH, {  defaultLocale: Locales.ENGLISH,  mode: "prefix-all",});// Trả về: { prefix: 'en/', localePrefix: 'en' }// Kiểm tra tiền tố cho locale tiếng PhápgetPrefix(Locales.FRENCH, {  defaultLocale: Locales.ENGLISH,  mode: "prefix-no-default",});// Trả về: { prefix: 'fr/', localePrefix: 'fr' }

Các chế độ định tuyến khác nhau

import { getPrefix, Locales } from "intlayer";// prefix-all: Luôn trả về tiền tốgetPrefix(Locales.ENGLISH, {  mode: "prefix-all",  defaultLocale: Locales.ENGLISH,});// Trả về: { prefix: '/en', localePrefix: 'en' }// prefix-no-default: Không có tiền tố khi locale trùng với mặc địnhgetPrefix(Locales.ENGLISH, {  mode: "prefix-no-default",  defaultLocale: Locales.ENGLISH,});// Trả về: { prefix: '', localePrefix: undefined }// prefix-no-default: Trả về tiền tố khi locale khác với mặc địnhgetPrefix(Locales.FRENCH, {  mode: "prefix-no-default",  defaultLocale: Locales.ENGLISH,});// Trả về: { prefix: 'fr/', localePrefix: 'fr' }// no-prefix & search-params: Không bao giờ trả về tiền tốgetPrefix(Locales.ENGLISH, { mode: "no-prefix" });// Trả về: { prefix: '', localePrefix: undefined }getPrefix(Locales.ENGLISH, { mode: "search-params" });// Trả về: { prefix: '', localePrefix: undefined }

import { getPrefix, Locales } from "intlayer";// prefix-all: Luôn trả về tiền tốgetPrefix(Locales.ENGLISH, {  mode: "prefix-all",  defaultLocale: Locales.ENGLISH,});// Trả về: { prefix: '/en', localePrefix: 'en' }// prefix-no-default: Không có tiền tố khi locale trùng với mặc địnhgetPrefix(Locales.ENGLISH, {  mode: "prefix-no-default",  defaultLocale: Locales.ENGLISH,});// Trả về: { prefix: '', localePrefix: undefined }// prefix-no-default: Trả về tiền tố khi locale khác với mặc địnhgetPrefix(Locales.FRENCH, {  mode: "prefix-no-default",  defaultLocale: Locales.ENGLISH,});// Trả về: { prefix: 'fr/', localePrefix: 'fr' }// no-prefix & search-params: Không bao giờ trả về tiền tốgetPrefix(Locales.ENGLISH, { mode: "no-prefix" });// Trả về: { prefix: '', localePrefix: undefined }getPrefix(Locales.ENGLISH, { mode: "search-params" });// Trả về: { prefix: '', localePrefix: undefined }

Ví dụ Thực tế

import { getPrefix, Locales } from "intlayer";// Xây dựng URL với tiền tố phù hợp cho một locale cụ thểconst locale = Locales.FRENCH;const { prefix, localePrefix } = getPrefix(locale, {  defaultLocale: Locales.ENGLISH,  mode: "prefix-no-default",});// Sử dụng prefix để xây dựng đường dẫnconst url1 = `/${prefix}about`.replace(/\/+/g, "/");// Kết quả: "/fr/about"// Sử dụng localePrefix để nhận diện localeconsole.log(`Current locale: ${localePrefix}`);// Kết quả: "Current locale: fr"

import { getPrefix, Locales } from "intlayer";// Xây dựng URL với tiền tố phù hợp cho một locale cụ thểconst locale = Locales.FRENCH;const { prefix, localePrefix } = getPrefix(locale, {  defaultLocale: Locales.ENGLISH,  mode: "prefix-no-default",});// Sử dụng prefix để xây dựng đường dẫnconst url1 = `/${prefix}about`.replace(/\/+/g, "/");// Kết quả: "/fr/about"// Sử dụng localePrefix để nhận diện localeconsole.log(`Current locale: ${localePrefix}`);// Kết quả: "Current locale: fr"

Các Hàm Liên Quan

getLocalizedUrl: Tạo URL có địa phương hóa cho một locale cụ thể
getMultilingualUrls: Tạo các URL cho tất cả các locale đã cấu hình

TypeScript

type GetPrefixResult = {  prefix: string; // Tiền tố đường dẫn có dấu gạch chéo ở cuối (ví dụ: 'fr/' hoặc '')  localePrefix?: Locale; // Định danh locale không có dấu gạch chéo (ví dụ: 'fr' hoặc undefined)};function getPrefix(  locale: Locales,  options?: {    defaultLocale?: Locales;    mode?: "prefix-no-default" | "prefix-all" | "no-prefix" | "search-params";  }): GetPrefixResult;

type GetPrefixResult = {  prefix: string; // Tiền tố đường dẫn có dấu gạch chéo ở cuối (ví dụ: 'fr/' hoặc '')  localePrefix?: Locale; // Định danh locale không có dấu gạch chéo (ví dụ: 'fr' hoặc undefined)};function getPrefix(  locale: Locales,  options?: {    defaultLocale?: Locales;    mode?: "prefix-no-default" | "prefix-all" | "no-prefix" | "search-params";  }): GetPrefixResult;

Tại sao Intlayer?