Thai Test Data
สร้างข้อมูลทดสอบภาษาไทยที่ผ่าน validation จริง ทั้งกรณีถูกและกรณีผิด
Realistic, valid Thai test data for QA and test automation, with negative cases built in.
Web app · Docs · Validator · Report a bug · Request a data type
Contents
Why
ระบบไทยส่วนใหญ่ตรวจ check digit ของเลขบัตรประชาชน และตรวจว่ารหัสไปรษณีย์ตรงกับจังหวัดหรือไม่
ถ้ากรอก 1111111111111 หรือที่อยู่มั่วๆ form จะไม่ผ่าน tester เลยต้องเสียเวลาหา test data ที่ "ถูกพอ" มาใช้ทุกครั้ง
Thai Test Data generate ข้อมูลที่ผ่าน validation ได้ทันที และ generate invalid data แบบตั้งใจได้ด้วย
แต่ละค่ามี expected result บอกไว้ เอาไปเขียน negative test case ได้เลย
ใช้ได้ 2 แบบ:
| For | How |
|---|
| 🌐 Web app | Manual / QA tester | เปิด thai-test-data.vercel.app เลือก data type ตั้งค่า แล้ว copy หรือ export เป็น CSV/JSON |
| 📦 Library | Automation tester | npm install thai-test-data แล้วเรียกใช้ใน Playwright, Cypress, Jest หรือ Vitest |
Features
- เลขบัตรประชาชนและเลขนิติบุคคล ที่ check digit ถูกต้อง กำหนดหลักแรก (ประเภทบุคคล 1–8) ได้
- เบอร์มือถือ ขึ้นต้น 06/08/09 มี format แบบมีขีดและ +66
- ชื่อ-นามสกุล ไทยและอังกฤษ มีคำนำหน้าทั้งแบบผู้ใหญ่และเด็ก เลือกเพศได้ ชื่อภาษาอังกฤษสะกดหลายแบบปนกันเหมือนของจริง (Kittipong, Kittiphong) และมีชื่อไม่ซ้ำกันพอสำหรับหลักแสนแถว
- ที่อยู่ครบ 77 จังหวัด 7,436 ตำบล ที่จังหวัด อำเภอ ตำบล และรหัสไปรษณีย์ตรงกันจริง มี format ภาษาอังกฤษ
- รหัสไปรษณีย์ 966 รหัส พร้อม lookup ว่ารหัสเป็นของพื้นที่ไหน
- วันเกิด ตามช่วงอายุ format พ.ศ., แบบเต็ม หรือ ISO
- Negative cases ทุก data type เช่น check digit ผิด, ไม่ครบหลัก, มีตัวอักษรปน, รหัสไปรษณีย์ไม่ตรงจังหวัด, วันที่ 31/04
- Seedable ใส่ seed เดิมได้ข้อมูลชุดเดิม test fail แล้ว reproduce ได้
- Zero dependencies และเขียนด้วย TypeScript แบบ strict
Web app
- Generate ได้สูงสุด 100,000 รายการ เลื่อนดูได้ลื่นทุกแถว เลือก Unique เพื่อไม่ให้มีค่าซ้ำ
- ตัวกรองผลลัพธ์ ค้นหาด้วยข้อความหรือ regex, กรอง Valid / Invalid และกรองตามสาเหตุที่ invalid
- คัดลอกได้ทุกระดับ คลิกช่องเพื่อคัดลอกค่าเดียว, ปุ่มท้ายแถวคัดลอกทั้งแถวเป็น JSON, หรือส่งออกทั้งชุดเป็น CSV / JSON
- โหมดเต็มจอ พับเมนูซ้ายได้ ย้ายคอลัมน์ด้วยการลากหัวคอลัมน์ และปรับความกว้างได้ ไม่ต้องเลื่อนซ้าย-ขวา
- Validator แบบ regex tester ตรวจได้ทีละหลายบรรทัด บอกเหตุผลและวิธีคำนวณ check digit
- ทุกอย่างทำงานในเบราว์เซอร์ ไม่มีการส่งข้อมูลไปที่ไหน
Quick start
npm install --save-dev thai-test-data
import { createThaiData, isValidThaiId } from "thai-test-data";
const td = createThaiData({ seed: 42 }); // seed เดิม → ข้อมูลเดิมทุกครั้ง
td.citizenId(); // "5486152684282"
td.phone(); // "0931566048"
td.address().fullAddress; // "592/27 หมู่ 1 ถนนพหลโยธิน ตำบลสระพังทอง อำเภอเขาวง กาฬสินธุ์ 46160"
td.person(); // ชื่อ เลขบัตร เบอร์ อีเมล วันเกิด ที่อยู่ ของคนเดียวกัน
isValidThaiId("1-2345-67890-12-1"); // true
ต้องใช้ Node.js 20 ขึ้นไป package เป็น ES module
Usage
Playwright: positive และ negative test
import { test, expect } from "@playwright/test";
import { createThaiData } from "thai-test-data";
const td = createThaiData({ seed: 42 });
test("สมัครสมาชิกด้วยข้อมูลที่ถูกต้อง", async ({ page }) => {
const user = td.person();
await page.goto("/register");
await page.fill("#citizenId", user.citizenId);
await page.fill("#phone", user.phone);
await page.fill("#address", user.address.fullAddress);
await page.click("button[type=submit]");
await expect(page.getByText("สมัครสำเร็จ")).toBeVisible();
});
for (const kind of ["checksum", "short", "long", "letters"] as const) {
test(`ปฏิเสธเลขบัตรที่ผิดแบบ ${kind}`, async ({ page }) => {
await page.goto("/register");
await page.fill("#citizenId", td.invalidCitizenId(kind));
await page.click("button[type=submit]");
await expect(page.getByText("เลขบัตรประชาชนไม่ถูกต้อง")).toBeVisible();
});
}
เตรียม test data หลายรายการ
const users = td.many(100, () => td.person("female"));
const phones = td.unique(30000, td.phone); // 30,000 เบอร์ ไม่ซ้ำกัน
const chiangMaiZips = td.many(20, () => td.postalCode({ province: "เชียงใหม่" }));
Assert ข้อมูลที่ API ตอบกลับมา
import { isValidMobilePhone, lookupPostalCode } from "thai-test-data";
expect(isValidMobilePhone(response.phone)).toBe(true);
expect(lookupPostalCode(response.zip).map((l) => l.province)).toContain(response.province);
API Reference
สร้าง generator ด้วย createThaiData({ seed? }) แล้วเรียก method จาก instance ที่ได้ (ในตัวอย่างใช้ชื่อ td)
Valid data
| Method | Returns |
|---|
td.citizenId(firstDigit?) | เลขบัตรประชาชน 13 หลัก กำหนดหลักแรก 1–8 ได้ |
td.juristicId() | เลขผู้เสียภาษีนิติบุคคล ขึ้นต้นด้วย 0 |
td.phone(prefixes?) | เบอร์มือถือ 10 หลัก จำกัดเลขขึ้นต้นได้ เช่น ["08"] |
td.name(gender?) หรือ td.name({ gender?, titles? }) | ชื่อไทยและอังกฤษ พร้อมคำนำหน้า titles: "adult" (ค่าเริ่มต้น: นาย / นางสาว / นาง) หรือ "child" (เด็กชาย / เด็กหญิง) |
td.address(options?) | ที่อยู่ กรองได้ด้วย { province } หรือ { bangkok } |
td.postalCode(options?) | รหัสไปรษณีย์ที่มีใช้จริง กรองได้เหมือน address |
td.birthDate(minAge?, maxAge?) | Date ของวันเกิดตามช่วงอายุ (default 18–65) |
td.person(gender?) | ข้อมูลบุคคลครบชุด |
td.many(count, factory) | เรียก factory ซ้ำ count ครั้ง แล้วคืนเป็น array |
td.unique(count, factory, options?) | เหมือน many แต่ไม่มีค่าซ้ำ เช่น td.unique(30000, td.phone) throw ถ้าค่าที่เป็นไปได้ไม่พอ ใส่ { partial: true } เพื่อคืนเท่าที่หาได้แทน และใช้ key กำหนดว่าอะไรนับว่าซ้ำ |
td.random | random function ที่ใช้ seed เดียวกัน สำหรับ generate ข้อมูลแบบของตัวเอง |
Invalid data (negative cases)
| Method | kind (ตัวแรกคือ default) |
|---|
td.invalidCitizenId(kind?) | "checksum", "short" (12 หลัก), "long" (14 หลัก), "letters" |
td.invalidJuristicId(kind?) | เหมือน invalidCitizenId |
td.invalidPhone(kind?) | "prefix" (เช่น 02), "short", "long", "letters" |
td.invalidPostalCode(kind?) | "unknown" (5 หลักแต่ไม่มีจริง), "short", "long", "letters" |
Validators และ formatters
| Function | Description |
|---|
isValidThaiId(value) | validate เลข 13 หลัก (ไม่สนขีดและช่องว่าง) |
thaiIdCheckDigit(first12) | คำนวณ check digit จาก 12 หลักแรก |
formatThaiId(id) | 1234567890121 → 1-2345-67890-12-1 |
isValidMobilePhone(value) | validate เบอร์มือถือ 10 หลัก |
formatPhone(phone) / toE164(phone) | 081-234-5678 / +66812345678 |
isValidPostalCode(code) | เช็กว่ารหัสไปรษณีย์มีใช้จริง |
lookupPostalCode(code) | รายการตำบล อำเภอ จังหวัด ที่ใช้รหัสนี้ |
formatThaiDate(date) / formatThaiDateLong(date) | 26/10/2569 / 26 ตุลาคม 2569 |
formatIsoDate(date) | 2026-10-26 ตามเวลาท้องถิ่น |
toBuddhistYear(year) / toChristianYear(year) | แปลง ค.ศ. ↔ พ.ศ. |
ageOn(birth, today?) | อายุเต็มปี |
Reference data
| Constant | Contains |
|---|
PROVINCES | ชื่อจังหวัดไทยและอังกฤษ 77 จังหวัด |
LOCALITIES | ตำบลทั้งหมด พร้อมอำเภอ จังหวัด และรหัสไปรษณีย์ |
POSTAL_CODES | รหัสไปรษณีย์ที่มีใช้ทั้งหมด |
Project structure
Monorepo แบบ npm workspaces มี 2 workspace:
thai-test-data/
├── packages/
│ └── thai-test-data/ # library (publish ขึ้น npm)
│ ├── src/
│ │ ├── index.ts # createThaiData() และ export ทั้งหมด
│ │ ├── id.ts # เลขบัตรประชาชน เลขนิติบุคคล check digit
│ │ ├── phone.ts # เบอร์มือถือ
│ │ ├── name.ts # ชื่อ-นามสกุล
│ │ ├── address.ts # ที่อยู่
│ │ ├── postal.ts # รหัสไปรษณีย์
│ │ ├── date.ts # วันที่ พ.ศ.
│ │ ├── random.ts # seeded random
│ │ └── data/localities.ts # ข้อมูลตำบล (generated ห้ามแก้เอง)
│ ├── test/ # unit tests (Vitest)
│ └── scripts/ # build:data และ prepack
├── apps/
│ └── web/ # web app (deploy บน Vercel)
│ ├── index.html
│ ├── src/ # ES modules (โหลดตรงใน browser ไม่ต้อง bundle)
│ │ ├── main.js # entry: ต่อทุก view เข้าด้วยกัน
│ │ ├── core/ # DOM helpers, theme, routing, tooltips, regex
│ │ ├── generator/ # data types, ตัวกรองผลลัพธ์, virtual list, export
│ │ ├── validator/ # กฎตรวจแต่ละแบบ และหน้า regex tester
│ │ └── report/ # ฟอร์มเปิด GitHub issue
│ ├── styles/ # tokens, base, generator, validator, pages
│ ├── static/ # favicon และรูป preview ตอนแชร์ลิงก์ (og.png)
│ ├── test/ # unit tests ของ web app (node:test)
│ └── scripts/ # build (HTML ต่อหน้า, sitemap.xml, robots.txt) และ dev server
├── docs/ # รูปใน README
└── vercel.json # build web app จาก root
Development
git clone https://github.com/jodpacharapon/thai-test-data.git
cd thai-test-data
npm install
รันทุกคำสั่งจาก root ของ repo
| Command | Description |
|---|
npm test | run unit tests ของ library |
npm run test:web | build แล้ว run unit tests ของ web app (filter, export, validator rules) |
npm run typecheck | type check |
npm run build | build library ไปที่ packages/thai-test-data/dist/ |
npm run build:web | build library แล้วรวมกับ web app ไปที่ apps/web/dist/ |
npm run dev | build แล้ว serve web app ที่ http://localhost:8080 |
หน้าของ web app (URL, title และ description) กำหนดไว้ที่ apps/web/src/core/pages.js ตอน build จะสร้าง HTML แยกต่อหน้าพร้อม meta tags สำหรับ SEO, sitemap.xml และ robots.txt
Address data
ข้อมูลจังหวัด อำเภอ ตำบล และรหัสไปรษณีย์มาจาก
kongvut/thai-province-data
(MIT License, Copyright (c) 2025 Kongvut Sangkla) รายละเอียดอยู่ใน THIRD_PARTY_NOTICES.md
ข้อมูลผูกตำบลละ 1 รหัสไปรษณีย์ จึงอาจไม่มีรหัสเฉพาะของหน่วยงาน
Update เป็น version ใหม่:
git clone --depth 1 https://github.com/kongvut/thai-province-data /tmp/thai-province-data
npm run build:data -- /tmp/thai-province-data/api/latest/province_with_district_and_sub_district.json
แล้วแก้ SOURCE_COMMIT ใน build-localities.mjs ให้ตรงกับ commit ที่ใช้
Contributing
ยินดีรับทั้ง issue และ pull request ครับ อ่าน guideline ได้ที่ CONTRIBUTING.md
ดู release history ได้ที่ CHANGELOG.md
Roadmap ideas: เลขบัญชีธนาคาร, PromptPay, ทะเบียนรถ, เลขพาสปอร์ต, CLI, Python และ Robot Framework
Disclaimer
- All data produced by this project is synthetic and randomly generated. It is not taken from any
real person, database or government record. Names are common Thai names combined at random, and
addresses use real localities that are not linked to any real household or person.
- Generated ID numbers pass the public check-digit formula but are not issued by any authority.
A generated number may, by chance, match a number that belongs to a real person or company.
- Use this data only for software testing and development, in test or staging environments.
Do not use it to register for real services, open accounts, create or alter identity documents,
or impersonate anyone. Doing so may be a criminal offence in Thailand and in your own country.
- You are responsible for how you use this software and the data it produces, and for complying with
the laws that apply to you. The software is provided "as is", without warranty of any kind, as stated
in the MIT License.
- ข้อมูลทั้งหมดเป็นข้อมูลสังเคราะห์ที่สุ่มขึ้น ไม่ได้นำมาจากบุคคล ฐานข้อมูล หรือทะเบียนราชการใด
ชื่อเป็นชื่อไทยทั่วไปที่สุ่มจับคู่กัน ที่อยู่ใช้ชื่อพื้นที่จริงแต่ไม่ได้ผูกกับบ้านหรือบุคคลใด
- เลขที่สร้างผ่านสูตร check digit ที่เปิดเผยต่อสาธารณะ แต่ไม่ได้ออกโดยหน่วยงานใด
และอาจบังเอิญตรงกับเลขของบุคคลหรือนิติบุคคลจริงได้
- ใช้เพื่อทดสอบและพัฒนาซอฟต์แวร์เท่านั้น ในระบบ test หรือ staging ห้ามนำไปสมัครบริการจริง เปิดบัญชี
ทำหรือแก้ไขเอกสารแสดงตน หรือแอบอ้างเป็นผู้อื่น ซึ่งอาจเป็นความผิดทางอาญาทั้งในประเทศไทยและประเทศของผู้ใช้
- ผู้ใช้รับผิดชอบการใช้งานซอฟต์แวร์และข้อมูลที่ได้เอง รวมถึงการปฏิบัติตามกฎหมายที่เกี่ยวข้อง
ซอฟต์แวร์นี้ให้ใช้ตามสภาพ ("as is") โดยไม่มีการรับประกันใดๆ ตาม MIT License
License
MIT © jodpacharapon · ข้อมูลที่อยู่ © Kongvut Sangkla (MIT)
