Native: String

Колекція методів прототипу об'єкта String.

Див. також:

• MDC String

Метод String: test

Шукає збіг між рядком і регулярним виразом. Для отримання додаткової інформації див. MDC Regexp:test.

Синтаксис:

myString.test(regex[,params]);

Аргументи:

1. regex - (mixed) Рядок або регулярний вираз, з яким потрібно порівняти рядок.
2. params - (string, опціонально) Якщо перший параметр є рядком, будь-які параметри, які ви хочете передати регулярному виразу ('g' не має ефекту).

Повертає:

• (boolean) true, якщо збіг з регулярним виразом знайдено в цьому рядку.
• (boolean) false, якщо не знайдено

Приклади:

"I like cookies".test("cookie"); //returns true
"I like cookies".test("COOKIE", "i"); //returns true (ignore case)

"I like cookies".test("cake"); //returns false

Див. також:

• MDC Regular Expressions

Метод String: contains

Перевіряє, чи міститься переданий рядок у цьому рядку. Якщо переданий параметр separator, перевіряє, чи міститься рядок у списку значень, розділених цим параметром.

Синтаксис:

myString.contains(string[, separator]);

Аргументи:

1. string - (string) Рядок для пошуку.
2. separator - (string, опціонально) Рядок, що розділяє значення в цьому рядку (напр. Element classNames розділені пробілом ' ').

Повертає:

• (boolean) true, якщо рядок міститься в цьому рядку
• (boolean) false, якщо ні.

Приклади:

'a bc'.contains('bc'); //returns true
'a b c'.contains('c', ' '); //returns true

'a bc'.contains('b', ' '); //returns false

Метод String: trim

Видаляє початкові та кінцеві пробіли з рядка.

Синтаксис:

myString.trim();

Повертає:

• (string) Обрізаний рядок.

Приклади:

"    i like cookies     ".trim(); //"i like cookies"

Метод String: clean

Видаляє всі зайві пробіли з рядка та обрізає його (String:trim).

Синтаксис:

myString.clean();

Повертає:

• (string) Очищений рядок.

Приклади:

" i      like     cookies      \n\n".clean(); //returns "i like cookies"

Метод String: camelCase

Перетворює рядок з дефісами на camelCase рядок.

Синтаксис:

myString.camelCase();

Повертає:

• (string) Рядок у camelCase.

Приклади:

"I-like-cookies".camelCase(); //returns "ILikeCookies"

Метод String: hyphenate

Перетворює camelCase рядок на рядок з дефісами.

Синтаксис:

myString.hyphenate();

Повертає:

• (string) Рядок з дефісами.

Приклади:

"ILikeCookies".hyphenate(); //returns "I-like-cookies"

Метод String: capitalize

Перетворює першу літеру кожного слова в рядку на велику.

Синтаксис:

myString.capitalize();

Повертає:

• (string) Рядок з великими літерами.

Приклади:

"i like cookies".capitalize(); //returns "I Like Cookies"

Метод String: escapeRegExp

Екранує всі символи регулярних виразів у рядку.

Синтаксис:

myString.escapeRegExp();

Повертає:

• (string) Екранований рядок.

Приклади:

'animals.sheep[1]'.escapeRegExp(); //returns 'animals\.sheep\[1\]'

Метод String: toInt

Розбирає цей рядок і повертає число заданої основи.

Синтаксис:

myString.toInt([base]);

Аргументи:

1. base - (number, опціонально) Основа для використання (за замовчуванням 10).

Повертає:

• (number) Число.
• (NaN) Якщо рядок не є числовим, повертає NaN.

Приклади:

"4em".toInt(); //returns 4
"10px".toInt(); //returns 10

Див. також:

• MDC parseInt

Метод String: toFloat

Розбирає цей рядок і повертає число з плаваючою комою.

Синтаксис:

myString.toFloat();

Повертає:

• (number) Число з плаваючою комою.
• (NaN) Якщо рядок не є числовим, повертає NaN.

Приклади:

    "95.25%".toFloat(); //returns 95.25
    "10.848".toFloat(); //returns 10.848

Див. також:

• MDC parseFloat

Метод String: hexToRgb

Перетворює шістнадцяткове значення кольору на RGB. Вхідний рядок має бути в одному з наступних шістнадцяткових форматів кольору (з або без хеша). '#ffffff', '#fff', 'ffffff', або 'fff'

Синтаксис:

myString.hexToRgb([array]);

Аргументи:

1. array - (boolean, опціонально) Якщо передано true, виведе масив (напр. [255, 51, 0]) замість рядка (напр. "rgb(255,51,0)").

Повертає:

• (string) Рядок, що представляє колір у RGB.
• (array) Якщо встановлено прапорець array, буде повернено масив замість цього.

Приклади:

"#123".hexToRgb(); //returns "rgb(17,34,51)"
"112233".hexToRgb(); //returns "rgb(17,34,51)"
"#112233".hexToRgb(true); //returns [17, 34, 51]

Метод String: rgbToHex

Перетворює RGB значення кольору на шістнадцяткове. Вхідний рядок має бути в одному з наступних RGB форматів кольору. "rgb(255,255,255)", або "rgba(255,255,255,1)"

Синтаксис:

myString.rgbToHex([array]);

Аргументи:

1. array - (boolean, опціонально) Якщо передано true, виведе масив (напр. ['ff','33','00']) замість рядка (напр. "#ff3300").

Повертає:

• (string) Рядок, що представляє колір у шістнадцятковому форматі, або transparent, якщо четверте значення rgba у вхідному рядку дорівнює 0.
• (array) Якщо встановлено прапорець array, буде повернено масив замість цього.

Приклади:

"rgb(17,34,51)".rgbToHex(); //returns "#112233"
"rgb(17,34,51)".rgbToHex(true); //returns ['11','22','33']

"rgba(17,34,51,0)".rgbToHex(); //returns "transparent"

Див. також:

• Array:rgbToHex

Метод String: stripScripts

Видаляє з рядка теги <script> та все між ними.

Синтаксис:

myString.stripScripts([evaluate]);

Аргументи:

1. evaluate - (boolean, опціонально) Якщо передано true, скрипти всередині рядка будуть виконані.

Повертає:

• (string) - Рядок без видалених скриптів.

Приклади:

var myString = "<script>alert('Hello')</script>Hello, World.";
myString.stripScripts(); //Returns "Hello, World."

myString.stripScripts(true); //Alerts "Hello", then returns "Hello, World."

Метод String: substitute

Підставляє ключові слова в рядок за допомогою об'єкта/масиву. Видаляє невизначені ключові слова і ігнорує екрановані ключові слова.

Синтаксис:

myString.substitute(object[, regexp]);

Аргументи:

1. object - (mixed) Пари ключ/значення, що використовуються для підстановки в рядок.
2. regexp - (regexp, опціонально) Шаблон регулярного виразу для використання в ключових словах рядка, з глобальним прапорцем. За замовчуванням /\?{([^}]+)}/g .

Повертає:

• (string) - Рядок з підстановками.

Приклади:

var myString = "{subject} is {property_1} and {property_2}.";
var myObject = {subject: 'Jack Bauer', property_1: 'our lord', property_2: 'savior'};
myString.substitute(myObject); //Jack Bauer is our lord and savior