Kiểu dữ liệu trong TypeScript: string, number, boolean

Kiểu (type) trong TypeScript mô tả loại giá trị mà một biến có thể chứa. Bạn viết kiểu sau dấu hai chấm, let name: string, và trình biên dịch từ chối mọi đoạn code đặt sai loại giá trị vào đó. Các kiểu cơ bản là bảy kiểu nguyên thủy của JavaScript cùng object type cho mảng và đối tượng.

let title: string = "TypeScript";
let version: number = 7;
let isStrict: boolean = true;
let big: bigint = 9007199254740993n;
let id: symbol = Symbol("id");
let nothing: null = null;
let notSet: undefined = undefined;

let scores: number[] = [90, 72, 85];
let user: { name: string; age: number } = { name: "Ada", age: 36 };

console.log(title, version, isStrict, big, id);
console.log(nothing, notSet);
console.log(scores, user);

Các chú thích kiểu được kiểm tra lúc biên dịch rồi bị xóa đi. Chương trình được chạy là JavaScript thuần.

Các kiểu nguyên thủy

Tên kiểu viết thường. typeof lúc runtime trả về đúng những từ này cho hầu hết các kiểu, nên typeof x === "number" là cách kiểm tra kiểu nguyên thủy của một giá trị khi chương trình đang chạy.

Chú thích kiểu

Chú thích kiểu (type annotation) là : Type đặt sau biến, tham số hoặc danh sách tham số của hàm. Tham số là nơi chú thích kiểu quan trọng nhất, vì TypeScript không thể đoán nơi gọi sẽ truyền vào gì.

function describe(name: string, age: number, admin: boolean): string {
    return `${name} (${age})${admin ? " [admin]" : ""}`;
}

let label: string = describe("Ada", 36, true);
console.log(label); // Ada (36) [admin]

// Without an annotation, TypeScript infers the type from the value:
let count = 10; // count: number
count = count + 1;
console.log(count); // 11

Khi biến được khởi tạo trên cùng một dòng, chú thích kiểu thường là thừa: let count = 10 đã có kiểu number. Các quy tắc để bỏ kiểu có ở trang suy luận kiểu.

Sai kiểu là lỗi biên dịch

Gán một giá trị sai kiểu và trình biên dịch dừng lại trước khi bất cứ thứ gì được chạy:

// This does not compile: a string is not a number.
let port: number = 8080;
port = "3000";
console.log(port);

Trình biên dịch in ra:

index.ts(3,1): error TS2322: Type 'string' is not assignable to type 'number'.

Cách sửa là chuyển đổi giá trị, port = Number("3000"), hoặc đổi chú thích kiểu nếu biến thực sự cần chứa văn bản.

number: không có kiểu số nguyên

JavaScript lưu mọi số dưới dạng số thực dấu phẩy động 64 bit, nên TypeScript chỉ có một kiểu number. Số nguyên chính xác đến Number.MAX_SAFE_INTEGER (2 ** 53 - 1). Vượt quá mức đó, hãy dùng bigint.

let price: number = 19.99;
let quantity: number = 3; // also number: no int type

console.log(Number.isInteger(quantity)); // true
console.log(Number.isInteger(price));    // false
console.log(Math.trunc(7 / 2));          // 3 (integer division)
console.log(0.1 + 0.2);                  // 0.30000000000000004

console.log(Number.MAX_SAFE_INTEGER);     // 9007199254740991
console.log(Number.MAX_SAFE_INTEGER + 2); // 9007199254740992 (wrong)

let exact: bigint = 9007199254740991n + 2n;
console.log(exact); // 9007199254740993n

// @ts-expect-error: bigint and number cannot be mixed
const mixed = () => exact + 1;
console.log(exact + BigInt(1), Number(exact)); // 9007199254740994n 9007199254740992

bigint và number không trộn lẫn được: exact + 1 là lỗi biên dịch (TS2365: Operator '+' cannot be applied to types 'bigint' and '1'., trong đó '1' là kiểu literal của 1) và nếu có chạy thì cũng là TypeError lúc runtime. Hãy chuyển đổi tường minh một vế bằng BigInt(1) hoặc Number(exact), nhớ rằng Number làm tròn các giá trị vượt quá phạm vi an toàn.

Nếu bạn muốn một kiểu chỉ nhận số nguyên, TypeScript không biểu diễn được điều đó cho giá trị bất kỳ. Hãy kiểm tra bằng Number.isInteger ở chỗ giá trị đi vào chương trình.

boolean

boolean có đúng hai giá trị, true và false. Những giá trị chỉ là truthy (1, "yes") không phải boolean, nên hãy chuyển chúng thành boolean bằng Boolean(x) hoặc x !== 0.

let loggedIn: boolean = false;
const items: string[] = ["a", "b"];

const hasItems: boolean = items.length > 0;
const hasName: boolean = Boolean("Ada");

console.log(loggedIn, hasItems, hasName); // false true true

null và undefined

Khi bật strict (mặc định từ TypeScript 6.0), null và undefined là các kiểu riêng và không thuộc string, number hay kiểu nào khác. Một biến có thể để trống phải nói rõ điều đó bằng union:

let nickname: string | undefined;
console.log(nickname); // undefined

nickname = "Ace";
console.log(nickname.toUpperCase()); // ACE

let middleName: string | null = null;
console.log(middleName ?? "(none)"); // (none)

Đọc thuộc tính của một giá trị có thể là undefined là lỗi biên dịch cho đến khi bạn kiểm tra nó. Trang null và undefined nói về các phép kiểm tra, ?. và ??.

Sơ lược về mảng và đối tượng

Mọi thứ không phải kiểu nguyên thủy đều là object type. Ba dạng bạn gặp đầu tiên:

let tags: string[] = ["ts", "js"];               // array of strings
let point: { x: number; y: number } = { x: 1, y: 2 }; // object with two number properties
let greet: (name: string) => string = (n) => `hi ${n}`; // function type

Mỗi loại có trang riêng: mảng, tuple (mảng có độ dài cố định), object type và function type.

string, number, boolean và String, Number, Boolean

Các tên viết hoa là kiểu của đối tượng bao trong JavaScript (new String("x")), không phải của giá trị thông thường. Hãy chú thích kiểu bằng tên viết thường.

// This does not compile: String (the wrapper) is not string (the primitive).
const wrapped: String = "text";
const plain: string = wrapped;
console.log(plain);

index.ts(3,7): error TS2322: Type 'String' is not assignable to type 'string'.
  'string' is a primitive, but 'String' is a wrapper object. Prefer using 'string' when possible.

Đổi String thành string ở dòng đầu và khối code sẽ chạy. Điều tương tự áp dụng cho Number, Boolean, Symbol và BigInt. (Object là trường hợp khác: nó chấp nhận gần như mọi giá trị, kể cả kiểu nguyên thủy; xem phần object type.)

Các kiểu có sẵn khác

Vài kiểu khác cũng xuất hiện sớm. Mỗi kiểu có trang riêng.