A collection of the String Object prototype methods.

• Online Tutorial/Demo

• String

Pads a string with the specified character(s) either before or after the current value.

myString.pad(length, string, direction);

1. length - (number) the number of characters to pad.
2. string - (string) the string to use for padding; defaults to a space.
3. direction - (string) either "left", "right" or "both" (defaults to "right"); the side to add the padding.

var tonyTheTigerSez = "They're gr".pad(15, 'r') + 'eat!';
//returns "They're grrrrrreat!"

• (string) a string with the specified character repeated the specified number of times either to the right or left of the current value.

Repeats a string a specified number of times.

myString.repeat(times);

1. times - (number) The number of times to repeat the string.

var one = "1";
var eleventyOne = one.repeat(3);
//returns "111"

• (string) the string repeated the specified number of times.

Removes non-ascii characters and converts them to their most appropriate ascii character.

myString.standardize();

var bjorkProper = "Björk";
var bjorkAscii = bjorkProper.standardize();
//returns "Bjork"

• (string) a string without any non-ascii characters.

Get all the HTML tags from a given string.

myString.getTags([tag, contents]);

1. tag - (string; optional) if defined, returns the tags of the specified type in an array. If not defined, returns all tags in an array.
2. contents - (boolean; optional) if true, you are returned an array of tag matches and their contents.

var html = "<b>This is a string with <i>html</i> in it.</b>"
var tags = html.getTags();
//returns ["<b>", "<i>", "</i>", "</b>"]
var italics = html.getTags('i');
//returns ["<i>", "</i>"]
var italicsWithContent = html.getTags('i', true);
//returns ["<i>html</i>"]

• (array) An array of strings for each matched tag (important note: NOT elements, strings)

Currently, you cannot ask for all tags with their content. If you want the inner content of tags, you must specify the tag type.

Remove all html tags from a string.

myString.stripTags([tag, contents]);

1. tag - (string; optional) if defined, returns the tags of the specified type in an array. If not defined, returns all tags in an array.
2. contents - (boolean; optional) if true, you are returned an array of tag matches and their contents.

var html = "<b>This is a string with <i>html</i> in it.</b>"
var noHtml = html.stripTags();
//returns "This is a string with html in it."
var noItalics = html.stripTags('i');
//returns "<b>This is a string with html in it.</b>"
var noItalicsContent = html.stripTags('i', true);
returns "<b>This is a string with  in it.</b>"

• (string) a string with the appropriate HTML stripped

Replaces common special characters with their ASCII counterparts (smart quotes, elipse characters, stuff from MS Word, etc.).

var tidyString = stringWithBadChars.tidy();

• (string) the string with the non-ASCII characters replaced

Truncates a string after the given number of characters.

myString.truncate(max, trail, atChar);

1. max - (number) the maximum length of the string.
2. trail - (string, optional) the trail which will be appended to the string when it is truncated, defaults to … when only the max argument is passed.
3. atChar - (string, optional) a string which be truncated after. For example before a space.

• (string) the truncated string

'This is some random text'.truncate(15); // This is some ra…
'This is some random text'.truncate(15, '--'); // This is some ra--
'This is some random text'.truncate(15, '…', ' '); // This is some…