charAt() 是 JavaScript 字符串最基礎的實例方法之一,用於返回指定索引位置的字符。本文通過實例、語法表、邊界情況與常見陷阱,幫助你徹底掌握其用法。
str.charAt(index)
str.length - 1。''。const str = 'Hello world!';
console.log(str.charAt(0)); // "H"
console.log(str.charAt(1)); // "e"
console.log(str.charAt(2)); // "l"
console.log(str.charAt(99)); // "" (越界返回空串)
符合 ECMA-262 標準,與 [] 訪問器、codePointAt() 一致。
JavaScript 沒有 char 類型,返回值始終是 長度為 1 的字符串。
index < 0 或 index >= str.length 時返回 '',這與 str[index] 返回 undefined 不同,需注意區分。
對於 🌟、𝄞 等補充平面字符(UTF-16 佔 2 個代碼單元),charAt 只能返回單個代碼單元(半個字符),導致亂碼。需改用 str.codePointAt(i) 或 [...str][i]。
const emoji = '🌟'; // UTF-16: "\uD83C\uDF1F"
console.log(emoji.charAt(0)); // "\uD83C" (高代理項)
console.log(emoji.charAt(1)); // "\uDF1F" (低代理項)
console.log([...emoji][0]); // "🌟" 正確
console.log(emoji.codePointAt(0)); // 127775 (十進制碼點)
function capitalize(s) {
return s.charAt(0).toUpperCase() + s.slice(1);
}
console.log(capitalize('hello')); // "Hello"
function mask(str, start, len) {
const arr = [...str];
for (let i = start; i < start + len && i < arr.length; i++) arr[i] = '*';
return arr.join('');
}
console.log(mask('13812345678', 3, 4)); // "138****5678"
function isValidVarName(name) {
const first = name.charAt(0);
return /[a-zA-Z_$]/.test(first);
}
| 特性 | charAt(i) | str[i] | codePointAt(i) |
|---|---|---|---|
| 返回類型 | string (len=1) | string 或 undefined | number (碼點) |
| 越界行為 | '' | undefined | undefined |
| Emoji 支持 | ❌ 只取代理項 | ❌ 同 charAt | ✅ 完整碼點 |
| ES 版本 | ES1 | ES5 | ES6 |
typeof str.charAt(0) === 'string' 永遠為 true。[...str] 或 Array.from(str) 轉數組後再操作。charAt(-1) 返回 '',若需倒數請用 str[str.length - 1] 或 str.slice(-1)。charAt() 適合處理 BMP 平面字符 的單字符讀取。codePointAt() 或展開運算符 [...str]。[] 最大的行為差異。掌握這些細節,能讓你在表單驗證、文本處理、國際化場景下寫出更健壯的代碼。