JavaScript метод padStart()

Определение и применение

JavaScript метод padStart() ECMAScript 2017 позволяет дополнить текущую строку, начиная с её начала (слева) с помощью пробельного символа (по умолчанию), или заданной строкой, таким образом чтобы результирующая строка достигла заданной длины.

Обращаю Ваше внимание, что если Вам необходимо дополнить текущую строку, начиная с её конца (справа), то Вы можете воспользоваться методом padEnd() ECMAScript 2017 .

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
`padStart()`	57.0	48.0	44.0	10.0	Нет	15.0

JavaScript синтаксис:

// дополнить текущую строку пробельными символами до заданной длины
string.padStart( targetLength ); 

// дополнить текущую строку переданными символами до заданной длины
string.padStart( targetLength, padString  );

Версия JavaScript

ECMAScript 2017 (8th Edition, ECMA-262)

Значения параметров

Параметр	Описание
targetLength	Целое число, которое определяет длину текущей строки после того как она будет заполнена. Если значение отсутствует, или меньше длины текущей строки, то текущая строка будет возвращена с той же длиной (останется без изменений).
padString	Определяет строковое значение, которым будет дополнена текущая строка. При необходимости заданная строка может быть повторена с целью достижения заданной длины для текущей строки, или усечена, если заданная длина строки была достигнута ранее. Значение по умолчанию для этого параметра - " " (`U+0020`).

Параметр

Описание

targetLength

Целое число, которое определяет длину текущей строки после того как она будет заполнена. Если значение отсутствует, или меньше длины текущей строки, то текущая строка будет возвращена с той же длиной (останется без изменений).

padString

Определяет строковое значение, которым будет дополнена текущая строка. При необходимости заданная строка может быть повторена с целью достижения заданной длины для текущей строки, или усечена, если заданная длина строки была достигнута ранее. Значение по умолчанию для этого параметра - " " (U+0020).

Пример использования

var x = "string"; // инициализируем переменную, содержащую строку

x.padStart(); // x содержит значение "string"
x.padStart( 5 ); // x содержит значение "string"
x.padStart( 10 ); // x содержит значение "    string"
x.padStart( 20 ); // x содержит значение "              string"

x.padStart( 10, "."); // x содержит значение "....string"
x.padStart( 10, "---"); // x содержит значение "----string"
x.padStart( 10, "abc"); // x содержит значение "abcastring"

В следующем примере мы рассмотрим как с помощью методов padStart() и padEnd() ECMAScript 2017 подготовить и вывести на консоль значения из массива, выравнивая при этом длину строки конкретного элемента для удобного просмотра и чтения выведенной информации.

let array = ["147.13", "20.11", "40.99", "13.06", "255", "189"]; // инициализируем переменную, содержащую массив строковых значений
let outputValues = array.map( val => parseFloat( val ) // принимаем строку в качестве аргумента и возвращаем десятичное число
								    .toFixed( 2 ) // возвращаем строковое представление числа в нотации с фиксированной запятой (2 знака после запятой)
								    .padStart( 10 ) // дополняем слева текущую строку пробельными символами до заданной длины
								    .padEnd( 14, " RUR")); // дополняем справа текущую строку переданными символами до заданной длины

console.log( outputValues.join( "\n") );

// результат вывода будет следующим:

    147.13 RUR
     20.11 RUR
     40.99 RUR
     13.06 RUR
    255.00 RUR
    189.00 RUR

JavaScript String