Tempel class entity TypeORM dan dapatkan bentuk JSON yang dihasilkan entity tersebut saat Anda mengembalikannya dari API, diisi dengan nilai placeholder. Ditujukan untuk proyek NestJS atau Express yang langsung mengirim entity di respons dan butuh contoh Swagger atau contoh request/response untuk disepakati dengan frontend.
Nilai diambil dari tipe TypeScript di setiap properti, bukan dari opsi @Column. Kolom yang dideklarasikan @Column({ type: "decimal" }) dengan price: number karena itu keluar sebagai number 0.
TypeORM. Sertakan entity terkait dan enum agar objek bersarang bisa terisi.Hasil langsung berubah saat Anda mengetik. Entity yang tidak direferensikan entity lain menjadi objek JSON tingkat atas; jika ada beberapa entity yang tidak saling terkait, masing-masing muncul di bawah nama class-nya.enum Genre { Novel = "novel", Essay = "essay" }
@Entity()
export class Author {
@PrimaryGeneratedColumn()
id: number;
@Column()
name: string;
}
@Entity()
export class Book {
@PrimaryGeneratedColumn("uuid")
id: string;
@Column({ type: "enum", enum: Genre })
genre: Genre;
@Column({ type: "decimal", nullable: true })
price: number | null;
@ManyToOne(() => Author)
author: Author;
@Exclude()
@Column()
internalCode: string;
}{
"id": "",
"genre": "novel",
"price": 0,
"author": {
"id": 0,
"name": ""
}
}Book mereferensikan Author, jadi Book menjadi root dan author bersarang di dalamnya. internalCode dibuang karena @Exclude(), dan price, yang bertipe number | null, mengikuti tipe non-null pertama dan menjadi 0. Primary key uuid bertipe string, jadi berupa string kosong.
@ManyToOne dan @OneToOne menjadi objek bersarang; Post[] dari @OneToMany atau @ManyToMany menjadi array satu elemen.Promise<Post[]>) dan wrapper ESM Relation<User> dibuka menjadi tipe di dalamnya.@Exclude() dari class-transformer, field static, method, dan getter tidak disertakan.Date (dari @CreateDateColumn dan sejenisnya) menjadi string ISO seperti 1970-01-01T00:00:00.000Z.Record<string, number>, ditampilkan sebagai {"key": 0}.null atau array kosong agar nesting tetap terbatas.Controller yang langsung mengembalikan entity tetap butuh contoh payload untuk @ApiResponse. Tempel file entity lalu ganti nilai placeholder di hasil dengan nilai yang realistis.
Saat Anda melakukan query dengan relations: ["author"], frontend ingin tahu seberapa dalam respons bersarang. Output memperjelas field relasi mana yang berupa objek dan mana yang berupa array.
Gunakan output sebagai kerangka body request untuk pemanggilan POST di supertest. Hapus field yang dibuat otomatis seperti id dan timestamp, lalu isi sisanya.
@Column seperti nullable, default atau length tidak dibaca; nilainya diambil dari tipe properti atau initializer literal (status = "draft"). Jika sebuah kolom bisa null, ubah sendiri nilainya menjadi null.@Entity yang tidak saling mereferensikan semuanya dikonversi, dengan key berupa nama class ({ "Book": {...}, "Author": {...} }). Entity yang saling mereferensikan tetap menghasilkan satu root bersarang.null.@Expose, serialization group, dan @Transform yang dipakai bersama ClassSerializerInterceptor tidak diterapkan.@PrimaryGeneratedColumn("uuid") saya berupa string kosong?Hanya tipe properti yang menentukan nilainya. id: string menghasilkan ""; argumen "uuid" di decorator tidak dibaca. Untuk dokumentasi, ganti dengan nilai berbentuk UUID setelahnya.
Hasilnya sama dengan JSON.stringify dari entity yang dimuat penuh. Relasi yang tidak Anda muat dengan relations tidak akan ada di respons sebenarnya, jadi anggap field relasi di output sebagai kasus ketika relasinya dimuat.
Driver PostgreSQL dan MySQL mengembalikan nilai decimal sebagai string untuk menghindari hilangnya presisi. Deklarasikan properti sebagai price: string di entity dan output-nya, seperti data Anda yang sebenarnya, akan berupa string.