Tipe Data TypeScript: string, number, boolean, dan Lainnya

Tipe di TypeScript mendeskripsikan jenis nilai yang bisa disimpan sebuah variabel. Kamu menulis tipe setelah titik dua, let name: string, dan compiler menolak kode apa pun yang memasukkan jenis nilai yang salah ke sana. Tipe dasarnya adalah tujuh tipe primitif JavaScript, ditambah object type untuk array dan objek.

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);

Anotasi diperiksa saat kompilasi lalu dihapus. Program yang dijalankan adalah JavaScript biasa.

Tipe Primitif

Nama tipenya ditulis dengan huruf kecil. typeof saat runtime mengembalikan kata yang sama untuk sebagian besar tipe ini, jadi typeof x === "number" adalah cara memeriksa tipe primitif sebuah nilai saat program berjalan.

Anotasi Tipe

Anotasi adalah : Type setelah variabel, parameter, atau daftar parameter fungsi. Parameter adalah tempat anotasi paling penting, karena TypeScript tidak bisa menebak apa yang akan dikirim pemanggil.

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

Kalau variabel langsung diberi nilai di baris yang sama, anotasinya biasanya tidak perlu: let count = 10 sudah bertipe number. Aturan kapan tipe boleh tidak ditulis ada di halaman inferensi tipe.

Tipe yang Salah Adalah Error Kompilasi

Berikan nilai dengan tipe yang salah, dan compiler berhenti sebelum apa pun dijalankan:

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

Compiler mencetak:

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

Perbaikannya adalah mengonversi nilainya, port = Number("3000"), atau mengubah anotasinya kalau variabel itu memang seharusnya menyimpan teks.

number: Tidak Ada Tipe Integer

JavaScript menyimpan setiap angka sebagai nilai floating point 64-bit, jadi TypeScript hanya punya satu tipe number. Bilangan bulat akurat sampai Number.MAX_SAFE_INTEGER (2 ** 53 - 1). Di atas itu, pakai 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 dan number tidak bisa dicampur: exact + 1 adalah error kompilasi (TS2365: Operator '+' cannot be applied to types 'bigint' and '1'., dengan '1' sebagai tipe literal dari 1) dan, seandainya dijalankan, juga TypeError saat runtime. Konversikan salah satu sisi secara eksplisit dengan BigInt(1) atau Number(exact), dengan catatan bahwa Number membulatkan nilai yang melewati batas aman.

Kalau kamu ingin tipe yang hanya menerima bilangan bulat, TypeScript tidak bisa mengekspresikannya untuk nilai sembarang. Validasi dengan Number.isInteger di tempat nilai itu masuk ke programmu.

boolean

boolean punya tepat dua nilai, true dan false. Nilai yang sekadar truthy (1, "yes") bukan boolean, jadi ubah menjadi boolean dengan Boolean(x) atau 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 dan undefined

Dengan strict menyala (default sejak TypeScript 6.0), null dan undefined adalah tipe tersendiri dan bukan bagian dari string, number, atau tipe lain. Variabel yang mungkin kosong menyatakannya dengan 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)

Membaca property dari nilai yang mungkin undefined adalah error kompilasi sampai kamu memeriksanya. Halaman null dan undefined membahas pemeriksaannya, ?., dan ??.

Sekilas tentang Array dan Objek

Apa pun yang bukan primitif adalah object type. Tiga bentuk yang pertama kali kamu temui:

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

Masing-masing punya halaman sendiri: array, tuple (array dengan panjang tetap), object type, dan function type.

string, number, boolean vs String, Number, Boolean

Nama berhuruf kapital adalah tipe dari objek pembungkus JavaScript (new String("x")), bukan tipe nilai biasa. Beri anotasi dengan nama berhuruf kecil.

// 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.

Ubah String menjadi string di baris pertama dan blok itu bisa dijalankan. Hal yang sama berlaku untuk Number, Boolean, Symbol, dan BigInt. (Object adalah kasus yang berbeda: tipe ini menerima hampir semua nilai, termasuk primitif; lihat object type.)

Tipe Bawaan Lainnya

Ada beberapa tipe lain yang muncul sejak awal. Masing-masing punya halaman sendiri.