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 April 2017.

padStart() 메서드는 String 값의 메서드로, 결과 문자열이 주어진 길이에 도달할 때까지 이 문자열의 시작 부분에 다른 문자열을 (필요하다면 여러 번) 채웁니다. 패딩은 이 문자열의 시작 부분부터 적용됩니다.

시도해보기

const str1 = "5";

console.log(str1.padStart(2, "0"));
// Expected output: "05"

const fullNumber = "2034399002125581";
const last4Digits = fullNumber.slice(-4);
const maskedNumber = last4Digits.padStart(fullNumber.length, "*");

console.log(maskedNumber);
// Expected output: "************5581"

구문

js
padStart(targetLength)
padStart(targetLength, padString)

매개변수

targetLength

현재 str이 패딩된 후의 결과 문자열의 길이입니다. 만약 이 값이 str.length보다 작거나 같다면, str이 그대로 반환됩니다.

padString Optional

현재 str을 채우는 데 사용할 문자열입니다. 만약 padStringtargetLength 대비 너무 길다면, 끝 부분이 잘립니다. 기본값은 유니코드 "space" 문자 (U+0020)입니다.

반환 값

지정된 targetLengthString으로, padString이 시작 부분부터 적용됩니다.

예제

기본 예제

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

고정 길이 문자열 숫자 변환

js
// JavaScript version of: (unsigned)
// printf "%0*d" width num
function leftFillNum(num, targetLength) {
  return num.toString().padStart(targetLength, "0");
}

const num = 123;
console.log(leftFillNum(num, 5)); // "00123"

명세서

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

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
padStart

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

같이 보기