此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

String.prototype.padStart()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2017年4月⁩.

實驗性質: 這是一個實驗中的功能
此功能在某些瀏覽器尚在開發中,請參考兼容表格以得到不同瀏覽器用的前輟。

padStart() 會將用給定用於填充的字串,以重複的方式,插入到目標字串的起頭(左側),直到目標字串到達指定長度。

Syntax

js
str.padStart(targetLength [, padString])

Parameters

targetLength

目標字串被填充後的長度。如果此參數小於原字串的長度,那將直接返回原字串。

padString 選擇性

用來填充的字串。如果填充字串太長,則由左側開始,擷取所需要的長度。此參數預設值是空白 " " (U+0020).

Return value

目標字串被填充到指定長度後,所得的新字串。

Examples

js
"abc".padStart(10); // "       abc"
"abc".padStart(10, "foo"); // "foofoofabc"
"abc".padStart(6, "123465"); // "123abc"

規範

Specification
ECMAScript® 2026 Language Specification
# sec-string.prototype.padstart

瀏覽器相容性

參見