Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update(JS): web/javascript/reference/global_objects/string/localecompare #3836

Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ browser-compat: javascript.builtins.String.localeCompare

{{JSRef}}

Метод **`localeCompare()`** (порівняти за локаллю) значень {{jsxref("String")}} повертає число, яке вказує, чи переданий рядок під час сортування повинен стояти перед, після, або є еквівалентним до поточного рядка. В реалізаціях, що підтримують [API `Intl.Collator`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator), цей метод просто викликає `Intl.Collator`.
Метод **`localeCompare()`** (порівняти за локаллю) значень {{jsxref("String")}} повертає число, яке вказує, чи переданий рядок під час сортування повинен стояти перед, після, або є еквівалентним до поточного рядка. В реалізаціях, що підтримують [API `Intl.Collator`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator), цей метод делегує виконання до `Intl.Collator`.

Для порівняння великої кількості рядків (наприклад, під час сортування великих масивів) краще створити окремий об'єкт {{jsxref("Intl.Collator")}} і застосувати функцію, яка надається його методом {{jsxref("Intl/Collator/compare", "compare()")}}.

Expand Down Expand Up @@ -57,7 +57,8 @@ localeCompare(compareString, locales, options)
- Додатне, якщо `referenceStr` опиняється після `compareString`
- Повертає `0`, якщо рядки еквівалентні

> **Примітка:** Не варто покладатись на конкретні значення `-1` чи `1`.
> [!NOTE]
> Не варто покладатись на конкретні значення `-1` чи `1`.
>
> Додатні та від'ємні цілочисельні результати можуть відрізнятися залежно від браузера (так само як і між різними версіями одного браузера), оскільки специфікація ECMAScript формально вимагає лише від'ємність чи додатність значення, а не його величину. Деякі браузери можуть повертати `-2` чи `2`, або навіть якісь інші додатні чи від'ємні значення.

Expand Down
Loading