【JSリファレンス】String.prototype.padStart()

更新日：2024/06/14

String.prototype.padStart()は、Stringオブジェクト(Stringコンストラクターのインスタンス)のプロトタイプチェーンに組み込まれるメソッドです。

文字列が指定された文字数以下の場合、文字列の前方を特定の文字で穴埋めします。

 

■構文


String.prototype.padStart ( maxLength [ , fillString ] )
  1. maxLength: 戻り値の最小文字数
  2. fillString: 省略可能。規定値 " "(スペース)
現在の文字列の文字数がmaxLengthよりも大きい場合は、そのまま返す。
小さい場合は、前方をfillStringで穴埋めして返す

 

■使用例

const text1 = "あいう";
console.log( text1.padStart(2,"●") ); // あいう
console.log( text1.padStart(5,"●") ); // ●●あいう

サロゲート文字は長さ2として計算されます。

const text1 = "🐈🐈🐈";
console.log( text1.length ); // 6

console.log( text1.padStart(6,"●") ); // 🐈🐈🐈
console.log( text1.padStart(7,"●") ); // ●🐈🐈🐈

サロゲート文字を一文字として扱う場合は、独自コードで穴埋めする必要があります。

  // 6文字で穴埋め
const length = [...text1].length;
const text2 = "●".repeat( 6- length ) + text1;
console.log( text2 ); // ●●●🐈🐈🐈

 

関連ページ

●String.prototype.padEnd()
●String.prototype.repeat()
●【JavaScript】 文字列データの内部形式と関連メソッドについてまとめてみた
●【JavaScript】 ゼロやスペースで埋めして桁揃えする

更新日：2024/06/14

書いた人（管理人）：けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない？」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。