diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 3f80b7f9..5aff0112 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -56,7 +56,7 @@ jobs:
persist-credentials: false
- name: Set up Node.js
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version: 22
cache: npm
@@ -161,7 +161,7 @@ jobs:
persist-credentials: false
- name: Set up Node.js
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+ uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version: 22
cache: npm
@@ -315,7 +315,7 @@ jobs:
run: node scripts/docs/write-help-versions.mjs dir "$(node -p "require('./package.json').version")"
- name: Setup Pages
- uses: actions/configure-pages@1f0c5cde4bc74cd7e1254d0cb4de8d49e9068c7d # v4.0.0
+ uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
- name: Upload Pages artifact
uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
diff --git a/.github/workflows/release-please.yml b/.github/workflows/release-please.yml
index 588401ae..4ab388d1 100644
--- a/.github/workflows/release-please.yml
+++ b/.github/workflows/release-please.yml
@@ -37,7 +37,7 @@ jobs:
# ever been released and proposed 1.0.0.
- name: release-please-action
id: release
- uses: googleapis/release-please-action@5c625bfb5d1ff62eadeeb3772007f7f66fdcf071 # v4.4.1
+ uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5.0.0
with:
token: ${{ secrets.GITHUB_TOKEN }}
config-file: release-please-config.json
diff --git a/.github/workflows/scorecard.yml b/.github/workflows/scorecard.yml
index d32d11ef..dfb13a52 100644
--- a/.github/workflows/scorecard.yml
+++ b/.github/workflows/scorecard.yml
@@ -47,6 +47,6 @@ jobs:
retention-days: 5
- name: upload-sarif
- uses: github/codeql-action/upload-sarif@1fc58d04a4d4374f921bdac573c3811c240f9c26 # v4.39.2
+ uses: github/codeql-action/upload-sarif@33d7b85da1a04171e211befe2c739303b9a4c066 # v4.39.3
with:
sarif_file: results.sarif
diff --git a/README.md b/README.md
index 290f5bde..b91787b9 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,8 @@
+
+
diff --git a/config/eslint/custom-rules.ts b/config/eslint/custom-rules.ts index 7519ac9f..daa50c85 100644 --- a/config/eslint/custom-rules.ts +++ b/config/eslint/custom-rules.ts @@ -1,9 +1,11 @@ +import stylistic from "@stylistic/eslint-plugin"; import jsdoc from "eslint-plugin-jsdoc"; export default { files: ["**/*.{js,mjs,cjs,ts,tsx}"], plugins: { - jsdoc + jsdoc, + "@stylistic": stylistic }, rules: { "@typescript-eslint/no-unused-vars": "warn", @@ -68,14 +70,21 @@ export default { next: "*" } ], - "lines-around-comment": [ + // The @stylistic variant understands TypeScript bodies (interfaces, + // enums, type literals, modules), so it does not fight Prettier there. + "lines-around-comment": "off", + "@stylistic/lines-around-comment": [ "warn", { beforeBlockComment: true, allowBlockStart: true, allowObjectStart: true, allowArrayStart: true, - allowClassStart: true + allowClassStart: true, + allowInterfaceStart: true, + allowEnumStart: true, + allowTypeStart: true, + allowModuleStart: true } ], "max-depth": ["warn", 4], diff --git a/config/eslint/scripts.ts b/config/eslint/scripts.ts index b6e3fbf2..e1a0b480 100644 --- a/config/eslint/scripts.ts +++ b/config/eslint/scripts.ts @@ -1,12 +1,13 @@ /** - * Overrides for the maintenance scripts under `scripts/`. + * Overrides for the maintenance scripts under `scripts/` and the authoring + * inputs they load from `docs/` (`docs/content/authored/*.mjs`). * * These are build and integration-test files rather than library sources: * they are plain JavaScript, they run on a console, and the Apps Script ones * reach for the library through the shared global scope. */ export default { - files: ["scripts/**/*.{js,mjs,cjs}"], + files: ["scripts/**/*.{js,mjs,cjs}", "docs/**/*.{js,mjs,cjs}"], rules: { // A build script reports its progress; that is its interface. "no-console": "off", @@ -17,6 +18,11 @@ export default { // A bundler exists to read and write computed paths. "security/detect-non-literal-fs-filename": "off", + // The patterns parse repository sources and are built from constants + // in these files, never from outside input. + "security/detect-unsafe-regex": "off", + "security/detect-non-literal-regexp": "off", + // The lookups here are into objects these files declare themselves. "security/detect-object-injection": "off" } diff --git a/config/eslint/security.ts b/config/eslint/security.ts index 0201f027..40fed626 100644 --- a/config/eslint/security.ts +++ b/config/eslint/security.ts @@ -11,6 +11,10 @@ export default { security }, rules: { - ...security.configs.recommended.rules + ...security.configs.recommended.rules, + + // Flags every `obj[key]`. The keys here come from code, not from request + // input, and CodeQL already covers prototype pollution. + "security/detect-object-injection": "off" } }; diff --git a/docs/content/authored/_entry.mjs b/docs/content/authored/_entry.mjs index 18c96a19..2b6e5ee3 100644 --- a/docs/content/authored/_entry.mjs +++ b/docs/content/authored/_entry.mjs @@ -1,4 +1,6 @@ -/** Assembles one prose entry from a table keyed by field, then by language. */ +/** + * Assembles one prose entry from a table keyed by field, then by language. + */ const LANGUAGE_CODES = ["en", "ru", "uk", "de", "fr"]; @@ -28,7 +30,9 @@ export function entry({ return result; } -/** Short-hand for a value that is only described in one sentence per language. */ +/** + * Short-hand for a value that is only described in one sentence per language. + */ export function code(body) { return [{ body: ["```javascript", body, "```"].join("\n") }]; } diff --git a/docs/content/authored/a1.mjs b/docs/content/authored/a1.mjs index 35f13c34..5b100862 100644 --- a/docs/content/authored/a1.mjs +++ b/docs/content/authored/a1.mjs @@ -1,4 +1,6 @@ -/** Prose for the A1-notation and column-letter helpers. */ +/** + * Prose for the A1-notation and column-letter helpers. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/html.mjs b/docs/content/authored/html.mjs index 63294c85..cf9894c0 100644 --- a/docs/content/authored/html.mjs +++ b/docs/content/authored/html.mjs @@ -1,4 +1,6 @@ -/** Prose for the HTML and XML helpers. */ +/** + * Prose for the HTML and XML helpers. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/last-functions.mjs b/docs/content/authored/last-functions.mjs index 4d4246ca..c8a567b4 100644 --- a/docs/content/authored/last-functions.mjs +++ b/docs/content/authored/last-functions.mjs @@ -1,4 +1,6 @@ -/** Prose for the last of the Apps Script helpers. */ +/** + * Prose for the last of the Apps Script helpers. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/object.mjs b/docs/content/authored/object.mjs index 4b359f6a..7bee0358 100644 --- a/docs/content/authored/object.mjs +++ b/docs/content/authored/object.mjs @@ -1,4 +1,6 @@ -/** Prose for the object helpers and the JSON pair. */ +/** + * Prose for the object helpers and the JSON pair. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/path-misc.mjs b/docs/content/authored/path-misc.mjs index 83f2c31d..a8f11605 100644 --- a/docs/content/authored/path-misc.mjs +++ b/docs/content/authored/path-misc.mjs @@ -1,4 +1,6 @@ -/** Prose for the path helpers and the odds and ends. */ +/** + * Prose for the path helpers and the odds and ends. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/rest.mjs b/docs/content/authored/rest.mjs index cca88228..f0a345da 100644 --- a/docs/content/authored/rest.mjs +++ b/docs/content/authored/rest.mjs @@ -1,10 +1,14 @@ -/** Prose for the remaining functions and classes. */ +/** + * Prose for the remaining functions and classes. + */ import { code, entry } from "./_entry.mjs"; const NONE = { en: "", ru: "", uk: "", de: "", fr: "" }; -/** A shorter form for entries that need one paragraph and no parameters table beyond the obvious. */ +/** + * A shorter form for entries that need one paragraph and no parameters table beyond the obvious. + */ function simple({ seeAlso, examples, diff --git a/docs/content/authored/sheet-conditional.mjs b/docs/content/authored/sheet-conditional.mjs index fd13c318..ea2a0e18 100644 --- a/docs/content/authored/sheet-conditional.mjs +++ b/docs/content/authored/sheet-conditional.mjs @@ -1,4 +1,6 @@ -/** Prose for the conditional row and column operations, and the lookups. */ +/** + * Prose for the conditional row and column operations, and the lookups. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/sheet-guards.mjs b/docs/content/authored/sheet-guards.mjs index 143841be..a89d58ec 100644 --- a/docs/content/authored/sheet-guards.mjs +++ b/docs/content/authored/sheet-guards.mjs @@ -1,4 +1,6 @@ -/** Prose for the two-argument grid-range guards, the admin family and the leftovers. */ +/** + * Prose for the two-argument grid-range guards, the admin family and the leftovers. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/sheet-read.mjs b/docs/content/authored/sheet-read.mjs index 20bd21bf..64c73bbd 100644 --- a/docs/content/authored/sheet-read.mjs +++ b/docs/content/authored/sheet-read.mjs @@ -1,4 +1,6 @@ -/** Prose for reading a sheet, its schema and its formulas. */ +/** + * Prose for reading a sheet, its schema and its formulas. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/sheet-write.mjs b/docs/content/authored/sheet-write.mjs index a290c725..ca8190af 100644 --- a/docs/content/authored/sheet-write.mjs +++ b/docs/content/authored/sheet-write.mjs @@ -1,4 +1,6 @@ -/** Prose for the row and column operations on a sheet. */ +/** + * Prose for the row and column operations on a sheet. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/string.mjs b/docs/content/authored/string.mjs index 586e426b..65dc090e 100644 --- a/docs/content/authored/string.mjs +++ b/docs/content/authored/string.mjs @@ -1,4 +1,6 @@ -/** Prose for the string helpers. Example code is shared by every language. */ +/** + * Prose for the string helpers. Example code is shared by every language. + */ export const FUNCTIONS = { toCamelCase: { diff --git a/docs/content/authored/string2.mjs b/docs/content/authored/string2.mjs index 5f7bd4ba..84be1f3b 100644 --- a/docs/content/authored/string2.mjs +++ b/docs/content/authored/string2.mjs @@ -1,4 +1,6 @@ -/** Prose for the remaining string helpers. */ +/** + * Prose for the remaining string helpers. + */ const CASE_OPTION = { en: "`trim` trims the string and collapses runs of whitespace into single spaces.", diff --git a/docs/content/authored/string3.mjs b/docs/content/authored/string3.mjs index bca9a157..bba00fe2 100644 --- a/docs/content/authored/string3.mjs +++ b/docs/content/authored/string3.mjs @@ -1,8 +1,12 @@ -/** Prose for the remaining string helpers: escaping, templating and versions. */ +/** + * Prose for the remaining string helpers: escaping, templating and versions. + */ const L = ["en", "ru", "uk", "de", "fr"]; -/** Assembles one entry from a table keyed by field, then by language. */ +/** + * Assembles one entry from a table keyed by field, then by language. + */ export function entry({ examples, seeAlso, diff --git a/docs/content/authored/time-json.mjs b/docs/content/authored/time-json.mjs index 37696560..e454db38 100644 --- a/docs/content/authored/time-json.mjs +++ b/docs/content/authored/time-json.mjs @@ -1,4 +1,6 @@ -/** Prose for the JSON pair, the time helpers and the path helpers. */ +/** + * Prose for the JSON pair, the time helpers and the path helpers. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/content/authored/types.mjs b/docs/content/authored/types.mjs index 2f7d5247..f99f85cb 100644 --- a/docs/content/authored/types.mjs +++ b/docs/content/authored/types.mjs @@ -1,4 +1,6 @@ -/** Prose for the types, interfaces and classes the package exports. */ +/** + * Prose for the types, interfaces and classes the package exports. + */ import { code, entry } from "./_entry.mjs"; diff --git a/docs/readme/README.ar.md b/docs/readme/README.ar.md index bda2456e..11fc863d 100644 --- a/docs/readme/README.ar.md +++ b/docs/readme/README.ar.md @@ -12,7 +12,7 @@
@@ -215,16 +217,16 @@ console.log(rangeInfo.endColumnIndex); // 2
diff --git a/docs/readme/README.de.md b/docs/readme/README.de.md
index a4b48eac..37f5e377 100644
--- a/docs/readme/README.de.md
+++ b/docs/readme/README.de.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | **Deutsch** | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Diese Übersetzung wurde mit KI-Unterstützung aus [README.md](../../README.md) für Version 2.1.1 erstellt. Maßgeblich ist die englische README; Korrekturen sind willkommen — siehe [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Diese Übersetzung wurde mit KI-Unterstützung aus [README.md](../../README.md) für Version 3.0.0 erstellt. Maßgeblich ist die englische README; Korrekturen sind willkommen — siehe [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Werkzeuge für Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.es.md b/docs/readme/README.es.md
index 61cee187..b0e9bb65 100644
--- a/docs/readme/README.es.md
+++ b/docs/readme/README.es.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | **Español** | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Esta traducción se hizo con ayuda de IA a partir de [README.md](../../README.md) para la versión 2.1.1. La versión de referencia es el README en inglés; las correcciones son bienvenidas — consulta [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Esta traducción se hizo con ayuda de IA a partir de [README.md](../../README.md) para la versión 3.0.0. La versión de referencia es el README en inglés; las correcciones son bienvenidas — consulta [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Utilidades para Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.fr.md b/docs/readme/README.fr.md
index f3a4c5d6..bbc24819 100644
--- a/docs/readme/README.fr.md
+++ b/docs/readme/README.fr.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | **Français** | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Cette traduction a été réalisée avec l'aide de l'IA à partir de [README.md](../../README.md) pour la version 2.1.1. Le README anglais fait foi ; les corrections sont les bienvenues — voir [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Cette traduction a été réalisée avec l'aide de l'IA à partir de [README.md](../../README.md) pour la version 3.0.0. Le README anglais fait foi ; les corrections sont les bienvenues — voir [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Utilitaires pour Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.id.md b/docs/readme/README.id.md
index 8a256bd7..6df934d9 100644
--- a/docs/readme/README.id.md
+++ b/docs/readme/README.id.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | **Bahasa Indonesia** | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Terjemahan ini dibuat dengan bantuan AI dari [README.md](../../README.md) untuk versi 2.1.1. Versi acuannya adalah README berbahasa Inggris; koreksi sangat kami harapkan — lihat [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Terjemahan ini dibuat dengan bantuan AI dari [README.md](../../README.md) untuk versi 3.0.0. Versi acuannya adalah README berbahasa Inggris; koreksi sangat kami harapkan — lihat [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Utilitas untuk Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.it.md b/docs/readme/README.it.md
index 85817a58..c5e2fb90 100644
--- a/docs/readme/README.it.md
+++ b/docs/readme/README.it.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | **Italiano** | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Questa traduzione è stata realizzata con l'aiuto dell'IA a partire da [README.md](../../README.md) per la versione 2.1.1. La versione di riferimento è il README in inglese; le correzioni sono benvenute — consulta [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Questa traduzione è stata realizzata con l'aiuto dell'IA a partire da [README.md](../../README.md) per la versione 3.0.0. La versione di riferimento è il README in inglese; le correzioni sono benvenute — consulta [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Utility per Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.ja.md b/docs/readme/README.ja.md
index 73a12195..9439defb 100644
--- a/docs/readme/README.ja.md
+++ b/docs/readme/README.ja.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | **日本語** | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> この翻訳は、バージョン 2.1.1 の [README.md](../../README.md) をもとに AI の支援を受けて作成しました。正式な内容は英語版 README です。修正の提案を歓迎します。詳しくは [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations) をご覧ください。
+> この翻訳は、バージョン 3.0.0 の [README.md](../../README.md) をもとに AI の支援を受けて作成しました。正式な内容は英語版 README です。修正の提案を歓迎します。詳しくは [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations) をご覧ください。
# Google Apps Script™ 向けユーティリティ
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.ko.md b/docs/readme/README.ko.md
index 09a87608..1f332d93 100644
--- a/docs/readme/README.ko.md
+++ b/docs/readme/README.ko.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | **한국어** | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> 이 번역은 버전 2.1.1의 [README.md](../../README.md)를 바탕으로 AI의 도움을 받아 작성했습니다. 기준이 되는 버전은 영어 README이며, 수정 제안을 환영합니다. 자세한 내용은 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)를 참고하세요.
+> 이 번역은 버전 3.0.0의 [README.md](../../README.md)를 바탕으로 AI의 도움을 받아 작성했습니다. 기준이 되는 버전은 영어 README이며, 수정 제안을 환영합니다. 자세한 내용은 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)를 참고하세요.
# Google Apps Script™용 유틸리티
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.nl.md b/docs/readme/README.nl.md
index ce5d9cfd..dfb8e283 100644
--- a/docs/readme/README.nl.md
+++ b/docs/readme/README.nl.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | **Nederlands** | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Deze vertaling is met behulp van AI gemaakt op basis van [README.md](../../README.md) voor versie 2.1.1. De referentieversie is de Engelse README; correcties zijn welkom — zie [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Deze vertaling is met behulp van AI gemaakt op basis van [README.md](../../README.md) voor versie 3.0.0. De referentieversie is de Engelse README; correcties zijn welkom — zie [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Hulpprogramma's voor Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.pl.md b/docs/readme/README.pl.md
index 2e37b9a7..0fdc60fb 100644
--- a/docs/readme/README.pl.md
+++ b/docs/readme/README.pl.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | **Polski** | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> To tłumaczenie powstało z pomocą AI na podstawie [README.md](../../README.md) dla wersji 2.1.1. Wersją wzorcową jest angielskie README; poprawki są mile widziane — zajrzyj do [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> To tłumaczenie powstało z pomocą AI na podstawie [README.md](../../README.md) dla wersji 3.0.0. Wersją wzorcową jest angielskie README; poprawki są mile widziane — zajrzyj do [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Narzędzia dla Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.pt.md b/docs/readme/README.pt.md
index 17bddb38..ea5c212b 100644
--- a/docs/readme/README.pt.md
+++ b/docs/readme/README.pt.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | **Português** | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Esta tradução foi feita com ajuda de IA a partir do [README.md](../../README.md) para a versão 2.1.1. A versão de referência é o README em inglês; correções são bem-vindas — veja [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Esta tradução foi feita com ajuda de IA a partir do [README.md](../../README.md) para a versão 3.0.0. A versão de referência é o README em inglês; correções são bem-vindas — veja [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Utilitários para Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.ru.md b/docs/readme/README.ru.md
index b0395ec2..74fc055a 100644
--- a/docs/readme/README.ru.md
+++ b/docs/readme/README.ru.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | **Русский** | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Этот перевод выполнен с помощью ИИ по [README.md](../../README.md) для версии 2.1.1. Основной считается английская версия README; исправления приветствуются — см. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Этот перевод выполнен с помощью ИИ по [README.md](../../README.md) для версии 3.0.0. Основной считается английская версия README; исправления приветствуются — см. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Утилиты для Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.tr.md b/docs/readme/README.tr.md
index 636e5868..4bf99f4a 100644
--- a/docs/readme/README.tr.md
+++ b/docs/readme/README.tr.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | **Türkçe** | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Bu çeviri, 2.1.1 sürümü için [README.md](../../README.md) dosyasından yapay zekâ desteğiyle yapılmıştır. Referans sürüm İngilizce README'dir; düzeltmelerinizi bekliyoruz — bkz. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Bu çeviri, 3.0.0 sürümü için [README.md](../../README.md) dosyasından yapay zekâ desteğiyle yapılmıştır. Referans sürüm İngilizce README'dir; düzeltmelerinizi bekliyoruz — bkz. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Google Apps Script™ için yardımcı araçlar
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.uk.md b/docs/readme/README.uk.md
index 05465aeb..e0c4e3e9 100644
--- a/docs/readme/README.uk.md
+++ b/docs/readme/README.uk.md
@@ -10,7 +10,7 @@
[English](../../README.md) | **Українська** | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Цей переклад зроблено за допомогою ШІ з [README.md](../../README.md) для версії 2.1.1. Основною є англійська версія README; виправлення вітаються — див. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Цей переклад зроблено за допомогою ШІ з [README.md](../../README.md) для версії 3.0.0. Основною є англійська версія README; виправлення вітаються — див. [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Утиліти для Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.vi.md b/docs/readme/README.vi.md
index 81085219..307cf68c 100644
--- a/docs/readme/README.vi.md
+++ b/docs/readme/README.vi.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | **Tiếng Việt** | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> Bản dịch này được thực hiện với sự hỗ trợ của AI từ [README.md](../../README.md) cho phiên bản 2.1.1. Phiên bản tham chiếu là README tiếng Anh; mọi góp ý chỉnh sửa đều được hoan nghênh — xem [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
+> Bản dịch này được thực hiện với sự hỗ trợ của AI từ [README.md](../../README.md) cho phiên bản 3.0.0. Phiên bản tham chiếu là README tiếng Anh; mọi góp ý chỉnh sửa đều được hoan nghênh — xem [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations).
# Tiện ích cho Google Apps Script™
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.zh-TW.md b/docs/readme/README.zh-TW.md
index 02832351..75289f58 100644
--- a/docs/readme/README.zh-TW.md
+++ b/docs/readme/README.zh-TW.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | **繁體中文**
-> 本翻譯以 AI 輔助,依據版本 2.1.1 的 [README.md](../../README.md) 製作。參考版本為英文版 README;歡迎提出修正,請參閱 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)。
+> 本翻譯以 AI 輔助,依據版本 3.0.0 的 [README.md](../../README.md) 製作。參考版本為英文版 README;歡迎提出修正,請參閱 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)。
# Google Apps Script™ 工具函式庫
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/readme/README.zh.md b/docs/readme/README.zh.md
index ff29cda8..b1d2f7f0 100644
--- a/docs/readme/README.zh.md
+++ b/docs/readme/README.zh.md
@@ -10,7 +10,7 @@
[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | **简体中文** | [繁體中文](README.zh-TW.md)
-> 本译文借助 AI 根据 2.1.1 版本的 [README.md](../../README.md) 翻译而成。以英文版 README 为准;欢迎指正——请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)。
+> 本译文借助 AI 根据 3.0.0 版本的 [README.md](../../README.md) 翻译而成。以英文版 README 为准;欢迎指正——请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations)。
# Google Apps Script™ 实用工具库
@@ -19,6 +19,8 @@
+
+
diff --git a/docs/writerside-de/topics/reference-base.md b/docs/writerside-de/topics/reference-base.md index 2ff257f6..3ba48da7 100644 --- a/docs/writerside-de/topics/reference-base.md +++ b/docs/writerside-de/topics/reference-base.md @@ -12,168 +12,168 @@ Arrays und Objekten, JSON und HTML. Die Google-Apps-Script-Laufzeit brauchen sie Die Markierung **New** kennzeichnet eine im jüngsten Release hinzugekommene Funktion, **Deprecated** eine, die in einem künftigen Release entfernt werden soll. -| Funktion | Rückgabetyp | Kurzbeschreibung | -| :---------------------------------------------------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------- | -| [`chunk`](chunk.md) | `Array` | Teilt ein Array in aufeinanderfolgende Gruppen fester Größe und prüft beide Argumente. | -| [`compact`](compact.md) **New** | `Array` | Entfernt jeden falsy-Wert aus einem Array und verengt dabei den Elementtyp ohne Cast. | -| [`decodeHtml`](decodeHtml.md) | `String` | Verwandelt numerische Zeichenreferenzen zurück in Zeichen. | -| [`diff`](diff.md) **New** | `Number` | Gibt den Abstand zweier Daten in einer gewählten Einheit zurück. | -| [`encodeHtml`](encodeHtml.md) | `String` | Kodiert jedes Zeichen als numerische Zeichenreferenz. | -| [`equals`](equals.md) **New** | `Boolean` | Vergleicht zwei Werte tief und null-sicher. | -| [`escapeHtml`](escapeHtml.md) | `String` | Ersetzt die fünf Zeichen, die sonst als Markup gelesen würden. | -| [`escapeRegExp`](escapeRegExp.md) | `String` | Maskiert die Zeichen, die in einem regulären Ausdruck eine Bedeutung tragen. | -| [`escapeXml`](escapeXml.md) | `String` | Maskiert die von XML reservierten Zeichen. | -| [`first`](first.md) **New** | `Any` | Nimmt das erste Element eines Arrays oder dessen erste n Elemente, ohne eigene Leerprüfung. | -| [`flat`](flat.md) **New** | `Object` | Flacht ein verschachteltes Objekt auf eine Ebene mit Punktschlüsseln ab. | -| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Gibt zurück, wie viele Tage der Monat eines Datums hat. | -| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Gibt zurück, wie viele Tage von einem Datum bis zum Monatsende bleiben. | -| [`getPath`](getPath.md) **New** | `Any` | Liest eine verschachtelte Eigenschaft über einen Pfad, mit Rückfallwert. | -| [`hashCode`](hashCode.md) | `Number` | Erzeugt einen numerischen Hash für einen beliebigen Wert. | -| [`intersect`](intersect.md) **New** | `Array` | Findet die Werte, die in jedem der übergebenen Arrays vorkommen. | -| [`is2DArray`](is2DArray.md) | `Boolean` | Prüft, ob ein Wert ein nicht-leeres Array ist, dessen Elemente alle Arrays sind. | -| [`isArray`](isArray.md) | `Boolean` | Prüft, ob ein Wert ein Array ist. | -| [`isBoolean`](isBoolean.md) | `Boolean` | Prüft, ob ein Wert ein boolescher Wert ist. | -| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Prüft, ob ein Wert eine nicht-leere Matrix ist, deren Zeilen alle gleich lang sind. | -| [`isCountable`](isCountable.md) | `Boolean` | Prüft, ob ein Wert eine zählbare Zahl ist. | -| [`isDouble`](isDouble.md) **New** | `Boolean` | Prüft, ob ein Wert eine Zahl mit Nachkommateil ist. | -| [`isEmail`](isEmail.md) | `Boolean` | Prüft, ob ein Wert eine E-Mail-Adresse ist. | -| [`isEmpty`](isEmpty.md) | `Boolean` | Prüft, ob ein Wert leer ist. | -| [`isException`](isException.md) | `Boolean` | Prüft, ob ein Wert eine `Exception` ist. | -| [`isFloat`](isFloat.md) **New** | `Boolean` | Prüft, ob ein Wert eine Zahl mit Nachkommateil ist. | -| [`isFunction`](isFunction.md) | `Boolean` | Prüft, ob ein Wert eine Funktion ist. | -| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Prüft, ob ein Wert aufrufbar ist. | -| [`isInteger`](isInteger.md) | `Boolean` | Prüft, ob ein Wert eine ganze Zahl ist. | -| [`isLength`](isLength.md) | `Boolean` | Prüft, ob ein Wert eine gültige Array-Länge ist. | -| [`isNaN`](isNaN.md) **New** | `Boolean` | Prüft, ob ein Wert die Zahl `NaN` ist. | -| [`isNil`](isNil.md) | `Boolean` | Prüft, ob ein Wert `null` oder `undefined` ist. | -| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Prüft, ob ein Wert eine nicht negative Zahl ist. | -| [`isNull`](isNull.md) | `Boolean` | Prüft, ob ein Wert `null` ist. | -| [`isNumber`](isNumber.md) | `Boolean` | Prüft, ob ein Wert eine Zahl ist. | -| [`isNumberLike`](isNumberLike.md) | `Boolean` | Prüft, ob ein Wert in eine Zahl umwandelbar ist. | -| [`isObject`](isObject.md) | `Boolean` | Prüft, ob ein Wert ein Objekt ist. | -| [`isObjectLike`](isObjectLike.md) | `Boolean` | Prüft, ob ein Wert objektartig ist. | -| [`isRegExp`](isRegExp.md) | `Boolean` | Prüft, ob ein Wert ein regulärer Ausdruck ist. | -| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Prüft, ob ein Wert eine sichere ganze Zahl ist. | -| [`isScalar`](isScalar.md) | `Boolean` | Prüft, ob ein Wert ein Skalar ist. | -| [`isString`](isString.md) | `Boolean` | Prüft, ob ein Wert eine Zeichenkette ist. | -| [`isSymbol`](isSymbol.md) | `Boolean` | Prüft, ob ein Wert ein Symbol ist. | -| [`last`](last.md) **New** | `Any` | Nimmt das letzte Element eines Arrays oder dessen letzte n Elemente in ursprünglicher Reihenfolge. | -| [`merge`](merge.md) **New** | `String` | Füllt die `{{ key }}`-Platzhalter einer Vorlage aus einem Objekt. | -| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Zahl mit Nachkommateil ist. | -| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Gibt den Wert als nicht leere Zeichenkette zurück und nennt im Fehlerfall das Argument. | -| [`isUndefined`](isUndefined.md) | `Boolean` | Prüft, ob ein Wert `undefined` ist. | -| [`isUrl`](isUrl.md) | `Boolean` | Prüft, ob ein Wert eine URL ist. | -| [`isValidLocale`](isValidLocale.md) | `Boolean` | Prüft, ob ein Wert ein Gebietsschema-Code ist. | -| [`isValidSlug`](isValidSlug.md) | `Boolean` | Prüft, ob ein Wert ein Slug ist. | -| [`isValidVersion`](isValidVersion.md) | `Boolean` | Prüft, ob ein Wert eine Versionsangabe ist. | -| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Prüft, ob eine Version mindestens der geforderten entspricht. | -| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Prüft, ob ein Wert **kein** nicht-leeres zweidimensionales Array ist. | -| [`nonArray`](nonArray.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein Array ist. | -| [`nonBoolean`](nonBoolean.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein boolescher Wert ist. | -| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Prüft, ob ein Wert **keine** Matrix mit gleich langen Zeilen ist. | -| [`nonEmpty`](nonEmpty.md) | `Boolean` | Prüft, ob ein Wert **nicht** leer ist. | -| [`nonException`](nonException.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine `Exception` ist. | -| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Zahl mit Nachkommateil ist. | -| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Funktion ist. | -| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine zählbare Zahl ist. | -| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** aufrufbar ist. | -| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine ganze Zahl ist. | -| [`nonLength`](nonLength.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine gültige Array-Länge ist. | -| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** die Zahl `NaN` ist. | -| [`nonNil`](nonNil.md) | `Boolean` | Prüft, ob ein Wert **nicht** `null` oder `undefined` ist. | -| [`nonNull`](nonNull.md) | `Boolean` | Prüft, ob ein Wert **nicht** `null` ist. | -| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Prüft, ob ein Wert eine nicht negative Zahl ist. | -| [`nonNumber`](nonNumber.md) | `Boolean` | Prüft, ob ein Wert **nicht** eine Zahl ist. | -| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** in eine Zahl umwandelbar ist. | -| [`nonObject`](nonObject.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein Objekt ist. | -| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** objektartig ist. | -| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein regulärer Ausdruck ist. | -| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine sichere ganze Zahl ist. | -| [`nonScalar`](nonScalar.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein Skalar ist. | -| [`nonString`](nonString.md) | `Boolean` | Prüft, ob ein Wert **nicht** eine Zeichenkette ist. | -| [`nonSymbol`](nonSymbol.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein Symbol ist. | -| [`nonUndefined`](nonUndefined.md) | `Boolean` | Prüft, ob ein Wert **nicht** `undefined` ist. | -| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine URL ist. | -| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine E-Mail-Adresse ist. | -| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein Gebietsschema-Code ist. | -| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein Slug ist. | -| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Versionsangabe ist. | -| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Prüft, ob eine Version hinter der geforderten zurückbleibt. | -| [`now`](now.md) | `Number` | Gibt die aktuelle Zeit in Millisekunden seit der Epoche zurück. | -| [`ObjectTag`](ObjectTag.md) | `Enum` | Die internen Tags, die ein Wert melden kann, als benannte Konstanten. | -| [`objectToString`](objectToString.md) | `String` | Gibt den internen Tag eines Werts zurück. | -| [`offset`](offset.md) **New** | `Date` | Verschiebt ein Datum um eine Anzahl einer Einheit. | -| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Liest JSON und versucht es bei striktem Fehlschlag mit einem toleranten Leser erneut. | -| [`require2DArray`](require2DArray.md) **New** | `Array` | Gibt den Wert als nicht-leeres zweidimensionales Array zurück oder wirft. | -| [`requireArray`](requireArray.md) **New** | `Array` | Gibt den Wert als ein Array zurück oder wirft. | -| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Gibt den Wert als einen booleschen Wert zurück oder wirft. | -| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Gibt den Wert als Matrix mit gleich langen Zeilen zurück oder wirft und benennt die Zeile. | -| [`requireCountable`](requireCountable.md) **New** | `Number` | Gibt den Wert als eine zählbare Zahl zurück oder wirft. | -| [`requireDouble`](requireDouble.md) **New** | `Number` | Gibt den Wert als eine Zahl mit Nachkommateil zurück oder wirft. | -| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Gibt den Wert als einen leeren Wert zurück oder wirft. | -| [`requireException`](requireException.md) **New** | `Exception` | Gibt den Wert als eine `Exception` zurück oder wirft. | -| [`requireFloat`](requireFloat.md) **New** | `Number` | Gibt den Wert als eine Zahl mit Nachkommateil zurück oder wirft. | -| [`requireFunction`](requireFunction.md) **New** | `Function` | Gibt den Wert als eine Funktion zurück oder wirft. | -| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Gibt den Wert als einen aufrufbaren Wert zurück oder wirft. | -| [`requireInteger`](requireInteger.md) **New** | `Number` | Gibt den Wert als eine ganze Zahl zurück oder wirft. | -| [`requireLength`](requireLength.md) **New** | `Number` | Gibt den Wert als eine gültige Array-Länge zurück oder wirft. | -| [`requireNaN`](requireNaN.md) **New** | `Number` | Gibt den Wert als `NaN` zurück oder wirft. | -| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Gibt den Wert als `null` oder `undefined` zurück oder wirft. | -| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Array ist. | -| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein boolescher Wert ist. | -| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl mit Nachkommateil ist. | -| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht leer ist. | -| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl mit Nachkommateil ist. | -| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine ganze Zahl ist. | -| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht die Zahl `NaN` ist. | -| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine sichere ganze Zahl ist. | -| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Gibt den Wert als eine sichere ganze Zahl zurück oder wirft. | -| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Gibt den Wert als ein Symbol zurück oder wirft. | -| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Gibt den Wert als Zeichenkette mit Inhalt zurück oder wirft. | -| [`requireNonException`](requireNonException.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine `Exception` ist. | -| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Funktion ist. | -| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht aufrufbar ist. | -| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Gibt die Sammlung unverändert zurück, nachdem geprüft wurde, dass kein Element `null` oder `undefined` ist. | -| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine gültige Array-Länge ist. | -| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `null` oder `undefined` ist. | -| [`requireNonNull`](requireNonNull.md) | `any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `null` oder `undefined` ist. | -| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl ist. | -| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht in eine Zahl umwandelbar ist. | -| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Objekt ist. | -| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht objektartig ist. | -| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein regulärer Ausdruck ist. | -| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Skalar ist. | -| [`requireNonString`](requireNonString.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zeichenkette ist. | -| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Symbol ist. | -| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `undefined` ist. | -| [`requireNull`](requireNull.md) **New** | `Null` | Gibt den Wert als `null` zurück oder wirft. | -| [`requireNumber`](requireNumber.md) **New** | `Number` | Gibt den Wert als eine Zahl zurück oder wirft. | -| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Gibt den Wert als einen numerischen Wert zurück oder wirft. | -| [`requireObject`](requireObject.md) **New** | `Object` | Gibt den Wert als ein Objekt zurück oder wirft. | -| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Gibt den Wert als einen objektartigen Wert zurück oder wirft. | -| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Gibt den Wert als einen regulären Ausdruck zurück oder wirft. | -| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Gibt den Wert als einen Skalar zurück oder wirft. | -| [`requireState`](requireState.md) **New** | `void` | Behauptet, dass eine Bedingung gilt, und wirft, wenn nicht. | -| [`requireString`](requireString.md) | `String` | Gibt den Wert als eine Zeichenkette zurück oder wirft. | -| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Gibt den Wert als `undefined` zurück oder wirft. | -| [`requireUrl`](requireUrl.md) **New** | `String` | Gibt den Wert als eine URL zurück oder wirft. | -| [`requireValidEmail`](requireValidEmail.md) | `String` | Gibt den Wert als eine E-Mail-Adresse zurück oder wirft. | -| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Gibt den Wert als einen Gebietsschema-Code zurück oder wirft. | -| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Gibt den Wert als einen Slug zurück oder wirft. | -| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Gibt den Wert als eine Versionsangabe zurück oder wirft. | -| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Gibt die Version zurück, sobald sie die Anforderung erfüllt, sonst wirft sie. | -| [`retry`](retry.md) **New** | `T` | Ruft eine Funktion nach einem Fehler erneut auf, mit wachsender Wartezeit. | -| [`setPath`](setPath.md) **New** | `Object` | Schreibt eine verschachtelte Eigenschaft über einen Pfad und legt Fehlendes an. | -| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Misst die Zeit einer Folge benannter Aufgaben. | -| [`stringifyJson`](stringifyJson.md) | `String` | Serialisiert einen Wert nach JSON mit fester Schlüsselreihenfolge. | -| [`toCamelCase`](toCamelCase.md) | `String` | Fügt die Wörter einer Zeichenkette zu camelCase zusammen. | -| [`toInteger`](toInteger.md) | `Number \| null` | Liest eine Zahl aus einem Wert oder meldet, dass keine da ist. | -| [`toKebabCase`](toKebabCase.md) | `String` | Schreibt eine Zeichenkette in kebab-case. | -| [`toLowerCase`](toLowerCase.md) | `String` | Schreibt eine Zeichenkette klein und räumt auf Wunsch den Leerraum auf. | -| [`toProperCase`](toProperCase.md) | `String` | Schreibt den ersten Buchstaben jedes Wortes groß und den Rest klein. | -| [`toSnakeCase`](toSnakeCase.md) | `String` | Schreibt eine Zeichenkette in snake_case. | -| [`toUpperCase`](toUpperCase.md) | `String` | Schreibt eine Zeichenkette groß und räumt auf Wunsch den Leerraum auf. | -| [`transpose`](transpose.md) | `Array` | Vertauscht Zeilen und Spalten einer Matrix. | -| [`unique`](unique.md) **New** | `Array` | Entfernt Dubletten aus einem Array und behält das erste Vorkommen jedes Werts. | -| [`versionCompare`](versionCompare.md) | `Number` | Vergleicht zwei Versionsangaben numerisch. | -| [`without`](without.md) **New** | `Array` | Entfernt jedes Vorkommen der genannten Werte aus einem Array. | +| Funktion | Rückgabetyp | Kurzbeschreibung | +| :--- | :--- | :--- | :--- | +| [`chunk`](chunk.md) | `Array` | Teilt ein Array in aufeinanderfolgende Gruppen fester Größe und prüft beide Argumente. | +| [`compact`](compact.md) **New** | `Array` | Entfernt jeden falsy-Wert aus einem Array und verengt dabei den Elementtyp ohne Cast. | +| [`decodeHtml`](decodeHtml.md) | `String` | Verwandelt numerische Zeichenreferenzen zurück in Zeichen. | +| [`diff`](diff.md) **New** | `Number` | Gibt den Abstand zweier Daten in einer gewählten Einheit zurück. | +| [`encodeHtml`](encodeHtml.md) | `String` | Kodiert jedes Zeichen als numerische Zeichenreferenz. | +| [`equals`](equals.md) **New** | `Boolean` | Vergleicht zwei Werte tief und null-sicher. | +| [`escapeHtml`](escapeHtml.md) | `String` | Ersetzt die fünf Zeichen, die sonst als Markup gelesen würden. | +| [`escapeRegExp`](escapeRegExp.md) | `String` | Maskiert die Zeichen, die in einem regulären Ausdruck eine Bedeutung tragen. | +| [`escapeXml`](escapeXml.md) | `String` | Maskiert die von XML reservierten Zeichen. | +| [`first`](first.md) **New** | `Any` | Nimmt das erste Element eines Arrays oder dessen erste n Elemente, ohne eigene Leerprüfung. | +| [`flat`](flat.md) **New** | `Object` | Flacht ein verschachteltes Objekt auf eine Ebene mit Punktschlüsseln ab. | +| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Gibt zurück, wie viele Tage der Monat eines Datums hat. | +| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Gibt zurück, wie viele Tage von einem Datum bis zum Monatsende bleiben. | +| [`getPath`](getPath.md) **New** | `Any` | Liest eine verschachtelte Eigenschaft über einen Pfad, mit Rückfallwert. | +| [`hashCode`](hashCode.md) | `Number` | Erzeugt einen numerischen Hash für einen beliebigen Wert. | +| [`intersect`](intersect.md) **New** | `Array` | Findet die Werte, die in jedem der übergebenen Arrays vorkommen. | +| [`is2DArray`](is2DArray.md) | `Boolean` | Prüft, ob ein Wert ein nicht-leeres Array ist, dessen Elemente alle Arrays sind. | +| [`isArray`](isArray.md) | `Boolean` | Prüft, ob ein Wert ein Array ist. | +| [`isBoolean`](isBoolean.md) | `Boolean` | Prüft, ob ein Wert ein boolescher Wert ist. | +| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Prüft, ob ein Wert eine nicht-leere Matrix ist, deren Zeilen alle gleich lang sind. | +| [`isCountable`](isCountable.md) | `Boolean` | Prüft, ob ein Wert eine zählbare Zahl ist. | +| [`isDouble`](isDouble.md) **New** | `Boolean` | Prüft, ob ein Wert eine Zahl mit Nachkommateil ist. | +| [`isEmail`](isEmail.md) | `Boolean` | Prüft, ob ein Wert eine E-Mail-Adresse ist. | +| [`isEmpty`](isEmpty.md) | `Boolean` | Prüft, ob ein Wert leer ist. | +| [`isException`](isException.md) | `Boolean` | Prüft, ob ein Wert eine `Exception` ist. | +| [`isFloat`](isFloat.md) **New** | `Boolean` | Prüft, ob ein Wert eine Zahl mit Nachkommateil ist. | +| [`isFunction`](isFunction.md) | `Boolean` | Prüft, ob ein Wert eine Funktion ist. | +| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Prüft, ob ein Wert aufrufbar ist. | +| [`isInteger`](isInteger.md) | `Boolean` | Prüft, ob ein Wert eine ganze Zahl ist. | +| [`isLength`](isLength.md) | `Boolean` | Prüft, ob ein Wert eine gültige Array-Länge ist. | +| [`isNaN`](isNaN.md) **New** | `Boolean` | Prüft, ob ein Wert die Zahl `NaN` ist. | +| [`isNil`](isNil.md) | `Boolean` | Prüft, ob ein Wert `null` oder `undefined` ist. | +| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Prüft, ob ein Wert eine nicht negative Zahl ist. | +| [`isNull`](isNull.md) | `Boolean` | Prüft, ob ein Wert `null` ist. | +| [`isNumber`](isNumber.md) | `Boolean` | Prüft, ob ein Wert eine Zahl ist. | +| [`isNumberLike`](isNumberLike.md) | `Boolean` | Prüft, ob ein Wert in eine Zahl umwandelbar ist. | +| [`isObject`](isObject.md) | `Boolean` | Prüft, ob ein Wert ein Objekt ist. | +| [`isObjectLike`](isObjectLike.md) | `Boolean` | Prüft, ob ein Wert objektartig ist. | +| [`isRegExp`](isRegExp.md) | `Boolean` | Prüft, ob ein Wert ein regulärer Ausdruck ist. | +| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Prüft, ob ein Wert eine sichere ganze Zahl ist. | +| [`isScalar`](isScalar.md) | `Boolean` | Prüft, ob ein Wert ein Skalar ist. | +| [`isString`](isString.md) | `Boolean` | Prüft, ob ein Wert eine Zeichenkette ist. | +| [`isSymbol`](isSymbol.md) | `Boolean` | Prüft, ob ein Wert ein Symbol ist. | +| [`last`](last.md) **New** | `Any` | Nimmt das letzte Element eines Arrays oder dessen letzte n Elemente in ursprünglicher Reihenfolge. | +| [`merge`](merge.md) **New** | `String` | Füllt die `{{ key }}`-Platzhalter einer Vorlage aus einem Objekt. | +| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Zahl mit Nachkommateil ist. | +| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Gibt den Wert als nicht leere Zeichenkette zurück und nennt im Fehlerfall das Argument. | +| [`isUndefined`](isUndefined.md) | `Boolean` | Prüft, ob ein Wert `undefined` ist. | +| [`isUrl`](isUrl.md) | `Boolean` | Prüft, ob ein Wert eine URL ist. | +| [`isValidLocale`](isValidLocale.md) | `Boolean` | Prüft, ob ein Wert ein Gebietsschema-Code ist. | +| [`isValidSlug`](isValidSlug.md) | `Boolean` | Prüft, ob ein Wert ein Slug ist. | +| [`isValidVersion`](isValidVersion.md) | `Boolean` | Prüft, ob ein Wert eine Versionsangabe ist. | +| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Prüft, ob eine Version mindestens der geforderten entspricht. | +| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Prüft, ob ein Wert **kein** nicht-leeres zweidimensionales Array ist. | +| [`nonArray`](nonArray.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein Array ist. | +| [`nonBoolean`](nonBoolean.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein boolescher Wert ist. | +| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Prüft, ob ein Wert **keine** Matrix mit gleich langen Zeilen ist. | +| [`nonEmpty`](nonEmpty.md) | `Boolean` | Prüft, ob ein Wert **nicht** leer ist. | +| [`nonException`](nonException.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine `Exception` ist. | +| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Zahl mit Nachkommateil ist. | +| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Funktion ist. | +| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine zählbare Zahl ist. | +| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** aufrufbar ist. | +| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine ganze Zahl ist. | +| [`nonLength`](nonLength.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine gültige Array-Länge ist. | +| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** die Zahl `NaN` ist. | +| [`nonNil`](nonNil.md) | `Boolean` | Prüft, ob ein Wert **nicht** `null` oder `undefined` ist. | +| [`nonNull`](nonNull.md) | `Boolean` | Prüft, ob ein Wert **nicht** `null` ist. | +| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Prüft, ob ein Wert eine nicht negative Zahl ist. | +| [`nonNumber`](nonNumber.md) | `Boolean` | Prüft, ob ein Wert **nicht** eine Zahl ist. | +| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** in eine Zahl umwandelbar ist. | +| [`nonObject`](nonObject.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein Objekt ist. | +| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** objektartig ist. | +| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein regulärer Ausdruck ist. | +| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine sichere ganze Zahl ist. | +| [`nonScalar`](nonScalar.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein Skalar ist. | +| [`nonString`](nonString.md) | `Boolean` | Prüft, ob ein Wert **nicht** eine Zeichenkette ist. | +| [`nonSymbol`](nonSymbol.md) | `Boolean` | Prüft, ob ein Wert **nicht** ein Symbol ist. | +| [`nonUndefined`](nonUndefined.md) | `Boolean` | Prüft, ob ein Wert **nicht** `undefined` ist. | +| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine URL ist. | +| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine E-Mail-Adresse ist. | +| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein Gebietsschema-Code ist. | +| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** ein Slug ist. | +| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Prüft, ob ein Wert **nicht** eine Versionsangabe ist. | +| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Prüft, ob eine Version hinter der geforderten zurückbleibt. | +| [`now`](now.md) | `Number` | Gibt die aktuelle Zeit in Millisekunden seit der Epoche zurück. | +| [`ObjectTag`](ObjectTag.md) | `Enum` | Die internen Tags, die ein Wert melden kann, als benannte Konstanten. | +| [`objectToString`](objectToString.md) | `String` | Gibt den internen Tag eines Werts zurück. | +| [`offset`](offset.md) **New** | `Date` | Verschiebt ein Datum um eine Anzahl einer Einheit. | +| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Liest JSON und versucht es bei striktem Fehlschlag mit einem toleranten Leser erneut. | +| [`require2DArray`](require2DArray.md) **New** | `Array` | Gibt den Wert als nicht-leeres zweidimensionales Array zurück oder wirft. | +| [`requireArray`](requireArray.md) **New** | `Array` | Gibt den Wert als ein Array zurück oder wirft. | +| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Gibt den Wert als einen booleschen Wert zurück oder wirft. | +| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Gibt den Wert als Matrix mit gleich langen Zeilen zurück oder wirft und benennt die Zeile. | +| [`requireCountable`](requireCountable.md) **New** | `Number` | Gibt den Wert als eine zählbare Zahl zurück oder wirft. | +| [`requireDouble`](requireDouble.md) **New** | `Number` | Gibt den Wert als eine Zahl mit Nachkommateil zurück oder wirft. | +| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Gibt den Wert als einen leeren Wert zurück oder wirft. | +| [`requireException`](requireException.md) **New** | `Exception` | Gibt den Wert als eine `Exception` zurück oder wirft. | +| [`requireFloat`](requireFloat.md) **New** | `Number` | Gibt den Wert als eine Zahl mit Nachkommateil zurück oder wirft. | +| [`requireFunction`](requireFunction.md) **New** | `Function` | Gibt den Wert als eine Funktion zurück oder wirft. | +| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Gibt den Wert als einen aufrufbaren Wert zurück oder wirft. | +| [`requireInteger`](requireInteger.md) **New** | `Number` | Gibt den Wert als eine ganze Zahl zurück oder wirft. | +| [`requireLength`](requireLength.md) **New** | `Number` | Gibt den Wert als eine gültige Array-Länge zurück oder wirft. | +| [`requireNaN`](requireNaN.md) **New** | `Number` | Gibt den Wert als `NaN` zurück oder wirft. | +| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Gibt den Wert als `null` oder `undefined` zurück oder wirft. | +| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Array ist. | +| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein boolescher Wert ist. | +| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl mit Nachkommateil ist. | +| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht leer ist. | +| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl mit Nachkommateil ist. | +| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine ganze Zahl ist. | +| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht die Zahl `NaN` ist. | +| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine sichere ganze Zahl ist. | +| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Gibt den Wert als eine sichere ganze Zahl zurück oder wirft. | +| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Gibt den Wert als ein Symbol zurück oder wirft. | +| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Gibt den Wert als Zeichenkette mit Inhalt zurück oder wirft. | +| [`requireNonException`](requireNonException.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine `Exception` ist. | +| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Funktion ist. | +| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht aufrufbar ist. | +| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Gibt die Sammlung unverändert zurück, nachdem geprüft wurde, dass kein Element `null` oder `undefined` ist. | +| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine gültige Array-Länge ist. | +| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `null` oder `undefined` ist. | +| [`requireNonNull`](requireNonNull.md) | `any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `null` oder `undefined` ist. | +| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zahl ist. | +| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht in eine Zahl umwandelbar ist. | +| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Objekt ist. | +| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht objektartig ist. | +| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein regulärer Ausdruck ist. | +| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Skalar ist. | +| [`requireNonString`](requireNonString.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht eine Zeichenkette ist. | +| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ein Symbol ist. | +| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht `undefined` ist. | +| [`requireNull`](requireNull.md) **New** | `Null` | Gibt den Wert als `null` zurück oder wirft. | +| [`requireNumber`](requireNumber.md) **New** | `Number` | Gibt den Wert als eine Zahl zurück oder wirft. | +| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Gibt den Wert als einen numerischen Wert zurück oder wirft. | +| [`requireObject`](requireObject.md) **New** | `Object` | Gibt den Wert als ein Objekt zurück oder wirft. | +| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Gibt den Wert als einen objektartigen Wert zurück oder wirft. | +| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Gibt den Wert als einen regulären Ausdruck zurück oder wirft. | +| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Gibt den Wert als einen Skalar zurück oder wirft. | +| [`requireState`](requireState.md) **New** | `void` | Behauptet, dass eine Bedingung gilt, und wirft, wenn nicht. | +| [`requireString`](requireString.md) | `String` | Gibt den Wert als eine Zeichenkette zurück oder wirft. | +| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Gibt den Wert als `undefined` zurück oder wirft. | +| [`requireUrl`](requireUrl.md) **New** | `String` | Gibt den Wert als eine URL zurück oder wirft. | +| [`requireValidEmail`](requireValidEmail.md) | `String` | Gibt den Wert als eine E-Mail-Adresse zurück oder wirft. | +| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Gibt den Wert als einen Gebietsschema-Code zurück oder wirft. | +| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Gibt den Wert als einen Slug zurück oder wirft. | +| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Gibt den Wert als eine Versionsangabe zurück oder wirft. | +| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Gibt die Version zurück, sobald sie die Anforderung erfüllt, sonst wirft sie. | +| [`retry`](retry.md) **New** | `T` | Ruft eine Funktion nach einem Fehler erneut auf, mit wachsender Wartezeit. | +| [`setPath`](setPath.md) **New** | `Object` | Schreibt eine verschachtelte Eigenschaft über einen Pfad und legt Fehlendes an. | +| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Misst die Zeit einer Folge benannter Aufgaben. | +| [`stringifyJson`](stringifyJson.md) | `String` | Serialisiert einen Wert nach JSON mit fester Schlüsselreihenfolge. | +| [`toCamelCase`](toCamelCase.md) | `String` | Fügt die Wörter einer Zeichenkette zu camelCase zusammen. | +| [`toInteger`](toInteger.md) | `Number \| null` | Liest eine Zahl aus einem Wert oder meldet, dass keine da ist. | +| [`toKebabCase`](toKebabCase.md) | `String` | Schreibt eine Zeichenkette in kebab-case. | +| [`toLowerCase`](toLowerCase.md) | `String` | Schreibt eine Zeichenkette klein und räumt auf Wunsch den Leerraum auf. | +| [`toProperCase`](toProperCase.md) | `String` | Schreibt den ersten Buchstaben jedes Wortes groß und den Rest klein. | +| [`toSnakeCase`](toSnakeCase.md) | `String` | Schreibt eine Zeichenkette in snake_case. | +| [`toUpperCase`](toUpperCase.md) | `String` | Schreibt eine Zeichenkette groß und räumt auf Wunsch den Leerraum auf. | +| [`transpose`](transpose.md) | `Array` | Vertauscht Zeilen und Spalten einer Matrix. | +| [`unique`](unique.md) **New** | `Array` | Entfernt Dubletten aus einem Array und behält das erste Vorkommen jedes Werts. | +| [`versionCompare`](versionCompare.md) | `Number` | Vergleicht zwei Versionsangaben numerisch. | +| [`without`](without.md) **New** | `Array` | Entfernt jedes Vorkommen der genannten Werte aus einem Array. | diff --git a/docs/writerside-fr/topics/reference-base.md b/docs/writerside-fr/topics/reference-base.md index e8b146fa..d42f09fd 100644 --- a/docs/writerside-fr/topics/reference-base.md +++ b/docs/writerside-fr/topics/reference-base.md @@ -13,168 +13,168 @@ nécessaire. La mention **New** signale une fonction ajoutée dans la dernière version ; **Deprecated** une fonction dont le retrait est prévu dans une version future. -| Fonction | Type de retour | Description brève | -| :---------------------------------------------------------------- | :--------------- | :---------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------- | -| [`chunk`](chunk.md) | `Array` | Découpe un tableau en groupes consécutifs de taille fixe, en validant les deux arguments. | -| [`compact`](compact.md) **New** | `Array` | Retire toutes les valeurs falsy d'un tableau et affine le type des éléments sans cast. | -| [`decodeHtml`](decodeHtml.md) | `String` | Retransforme les références numériques en caractères. | -| [`diff`](diff.md) **New** | `Number` | Renvoie l'intervalle entre deux dates dans l'unité choisie. | -| [`encodeHtml`](encodeHtml.md) | `String` | Encode chaque caractère en référence numérique. | -| [`equals`](equals.md) **New** | `Boolean` | Compare deux valeurs en profondeur et sans risque avec null. | -| [`escapeHtml`](escapeHtml.md) | `String` | Remplace les cinq caractères qui seraient autrement lus comme du balisage. | -| [`escapeRegExp`](escapeRegExp.md) | `String` | Échappe les caractères qui ont un sens dans une expression régulière. | -| [`escapeXml`](escapeXml.md) | `String` | Échappe les caractères réservés par XML. | -| [`first`](first.md) **New** | `Any` | Prend le premier élément d'un tableau, ou ses n premiers éléments, sans test de vacuité. | -| [`flat`](flat.md) **New** | `Object` | Aplatit un objet imbriqué en un seul niveau de clés pointées. | -| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Renvoie le nombre de jours du mois d'une date. | -| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Renvoie combien de jours séparent une date de la fin de son mois. | -| [`getPath`](getPath.md) **New** | `Any` | Lit une propriété imbriquée par chemin, avec valeur de repli. | -| [`hashCode`](hashCode.md) | `Number` | Produit un condensé numérique pour n'importe quelle valeur. | -| [`intersect`](intersect.md) **New** | `Array` | Trouve les valeurs présentes dans chacun des tableaux fournis. | -| [`is2DArray`](is2DArray.md) | `Boolean` | Vérifie qu'une valeur est un tableau non vide dont chaque élément est lui-même un tableau. | -| [`isArray`](isArray.md) | `Boolean` | Vérifie si une valeur est un tableau. | -| [`isBoolean`](isBoolean.md) | `Boolean` | Vérifie si une valeur est un booléen. | -| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Vérifie qu'une valeur est une matrice non vide dont toutes les lignes ont la même longueur. | -| [`isCountable`](isCountable.md) | `Boolean` | Vérifie si une valeur est un nombre dénombrable. | -| [`isDouble`](isDouble.md) **New** | `Boolean` | Vérifie si une valeur est un nombre avec une partie fractionnaire. | -| [`isEmail`](isEmail.md) | `Boolean` | Vérifie si une valeur est une adresse e-mail. | -| [`isEmpty`](isEmpty.md) | `Boolean` | Vérifie si une valeur est vide. | -| [`isException`](isException.md) | `Boolean` | Vérifie si une valeur est une `Exception`. | -| [`isFloat`](isFloat.md) **New** | `Boolean` | Vérifie si une valeur est un nombre avec une partie fractionnaire. | -| [`isFunction`](isFunction.md) | `Boolean` | Vérifie si une valeur est une fonction. | -| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Vérifie si une valeur est appelable. | -| [`isInteger`](isInteger.md) | `Boolean` | Vérifie si une valeur est un entier. | -| [`isLength`](isLength.md) | `Boolean` | Vérifie si une valeur est une longueur de tableau valide. | -| [`isNaN`](isNaN.md) **New** | `Boolean` | Vérifie si une valeur est le nombre `NaN`. | -| [`isNil`](isNil.md) | `Boolean` | Vérifie si une valeur est `null` ou `undefined`. | -| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Vérifie si une valeur est un nombre non négatif. | -| [`isNull`](isNull.md) | `Boolean` | Vérifie si une valeur est `null`. | -| [`isNumber`](isNumber.md) | `Boolean` | Vérifie si une valeur est un nombre. | -| [`isNumberLike`](isNumberLike.md) | `Boolean` | Vérifie si une valeur est convertible en nombre. | -| [`isObject`](isObject.md) | `Boolean` | Vérifie si une valeur est un objet. | -| [`isObjectLike`](isObjectLike.md) | `Boolean` | Vérifie si une valeur est de type objet. | -| [`isRegExp`](isRegExp.md) | `Boolean` | Vérifie si une valeur est une expression régulière. | -| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Vérifie si une valeur est un entier sûr. | -| [`isScalar`](isScalar.md) | `Boolean` | Vérifie si une valeur est un scalaire. | -| [`isString`](isString.md) | `Boolean` | Vérifie si une valeur est une chaîne de caractères. | -| [`isSymbol`](isSymbol.md) | `Boolean` | Vérifie si une valeur est un symbole. | -| [`last`](last.md) **New** | `Any` | Prend le dernier élément d'un tableau, ou ses n derniers éléments dans leur ordre d'origine. | -| [`merge`](merge.md) **New** | `String` | Remplit les emplacements `{{ key }}` d'un gabarit depuis un objet. | -| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre avec une partie fractionnaire. | -| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Renvoie la valeur comme chaîne non vide, en nommant l'argument en cas d'échec. | -| [`isUndefined`](isUndefined.md) | `Boolean` | Vérifie si une valeur est `undefined`. | -| [`isUrl`](isUrl.md) | `Boolean` | Vérifie si une valeur est une URL. | -| [`isValidLocale`](isValidLocale.md) | `Boolean` | Vérifie si une valeur est un code de locale. | -| [`isValidSlug`](isValidSlug.md) | `Boolean` | Vérifie si une valeur est un slug. | -| [`isValidVersion`](isValidVersion.md) | `Boolean` | Vérifie si une valeur est une chaîne de version. | -| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Vérifie qu'une version atteint au moins celle requise. | -| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un tableau bidimensionnel non vide. | -| [`nonArray`](nonArray.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un tableau. | -| [`nonBoolean`](nonBoolean.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un booléen. | -| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une matrice dont les lignes ont toutes la même longueur. | -| [`nonEmpty`](nonEmpty.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** vide. | -| [`nonException`](nonException.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une `Exception`. | -| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre avec une partie fractionnaire. | -| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une fonction. | -| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre dénombrable. | -| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** appelable. | -| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un entier. | -| [`nonLength`](nonLength.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une longueur de tableau valide. | -| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** le nombre `NaN`. | -| [`nonNil`](nonNil.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** `null` ou `undefined`. | -| [`nonNull`](nonNull.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** `null`. | -| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Vérifie qu'une valeur est un nombre non négatif. | -| [`nonNumber`](nonNumber.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre. | -| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** convertible en nombre. | -| [`nonObject`](nonObject.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un objet. | -| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** de type objet. | -| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une expression régulière. | -| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un entier sûr. | -| [`nonScalar`](nonScalar.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un scalaire. | -| [`nonString`](nonString.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** une chaîne de caractères. | -| [`nonSymbol`](nonSymbol.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un symbole. | -| [`nonUndefined`](nonUndefined.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** `undefined`. | -| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une URL. | -| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une adresse e-mail. | -| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un code de locale. | -| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un slug. | -| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une chaîne de version. | -| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Vérifie qu'une version reste en deçà de celle requise. | -| [`now`](now.md) | `Number` | Renvoie l'heure courante en millisecondes depuis l'époque. | -| [`ObjectTag`](ObjectTag.md) | `Enum` | Les tags internes qu'une valeur peut déclarer, sous forme de constantes nommées. | -| [`objectToString`](objectToString.md) | `String` | Renvoie le tag interne d'une valeur. | -| [`offset`](offset.md) **New** | `Date` | Décale une date d'un certain nombre d'unités. | -| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Analyse du JSON, puis réessaie avec un lecteur permissif si l'analyse stricte échoue. | -| [`require2DArray`](require2DArray.md) **New** | `Array` | Renvoie la valeur en tant que tableau bidimensionnel non vide, ou lève une exception. | -| [`requireArray`](requireArray.md) **New** | `Array` | Renvoie la valeur en tant que un tableau, ou lève une exception. | -| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Renvoie la valeur en tant que un booléen, ou lève une exception. | -| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Renvoie la valeur en tant que matrice à lignes de même longueur, ou lève en nommant la ligne fautive. | -| [`requireCountable`](requireCountable.md) **New** | `Number` | Renvoie la valeur en tant que un nombre dénombrable, ou lève une exception. | -| [`requireDouble`](requireDouble.md) **New** | `Number` | Renvoie la valeur en tant que un nombre avec une partie fractionnaire, ou lève une exception. | -| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Renvoie la valeur en tant que une valeur vide, ou lève une exception. | -| [`requireException`](requireException.md) **New** | `Exception` | Renvoie la valeur en tant que une `Exception`, ou lève une exception. | -| [`requireFloat`](requireFloat.md) **New** | `Number` | Renvoie la valeur en tant que un nombre avec une partie fractionnaire, ou lève une exception. | -| [`requireFunction`](requireFunction.md) **New** | `Function` | Renvoie la valeur en tant que une fonction, ou lève une exception. | -| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Renvoie la valeur en tant que une valeur appelable, ou lève une exception. | -| [`requireInteger`](requireInteger.md) **New** | `Number` | Renvoie la valeur en tant que un entier, ou lève une exception. | -| [`requireLength`](requireLength.md) **New** | `Number` | Renvoie la valeur en tant que une longueur de tableau valide, ou lève une exception. | -| [`requireNaN`](requireNaN.md) **New** | `Number` | Renvoie la valeur en tant que `NaN`, ou lève une exception. | -| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Renvoie la valeur en tant que `null` ou `undefined`, ou lève une exception. | -| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un tableau. | -| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un booléen. | -| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre avec une partie fractionnaire. | -| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas vide. | -| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre avec une partie fractionnaire. | -| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un entier. | -| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas le nombre `NaN`. | -| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un entier sûr. | -| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Renvoie la valeur en tant que un entier sûr, ou lève une exception. | -| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Renvoie la valeur en tant que un symbole, ou lève une exception. | -| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Renvoie la valeur comme une chaîne non vide, ou lève. | -| [`requireNonException`](requireNonException.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une `Exception`. | -| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une fonction. | -| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas appelable. | -| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Renvoie la collection inchangée après avoir vérifié qu'aucun élément n'est `null` ni `undefined`. | -| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une longueur de tableau valide. | -| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas `null` ou `undefined`. | -| [`requireNonNull`](requireNonNull.md) | `any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas `null` ou `undefined`. | -| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre. | -| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas convertible en nombre. | -| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un objet. | -| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas de type objet. | -| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une expression régulière. | -| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un scalaire. | -| [`requireNonString`](requireNonString.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une chaîne de caractères. | -| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un symbole. | -| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas `undefined`. | -| [`requireNull`](requireNull.md) **New** | `Null` | Renvoie la valeur en tant que `null`, ou lève une exception. | -| [`requireNumber`](requireNumber.md) **New** | `Number` | Renvoie la valeur en tant que un nombre, ou lève une exception. | -| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Renvoie la valeur en tant que une valeur numérique, ou lève une exception. | -| [`requireObject`](requireObject.md) **New** | `Object` | Renvoie la valeur en tant que un objet, ou lève une exception. | -| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Renvoie la valeur en tant que une valeur de type objet, ou lève une exception. | -| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Renvoie la valeur en tant que une expression régulière, ou lève une exception. | -| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Renvoie la valeur en tant que un scalaire, ou lève une exception. | -| [`requireState`](requireState.md) **New** | `void` | Affirme qu'une condition tient, et lève dans le cas contraire. | -| [`requireString`](requireString.md) | `String` | Renvoie la valeur en tant que une chaîne de caractères, ou lève une exception. | -| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Renvoie la valeur en tant que `undefined`, ou lève une exception. | -| [`requireUrl`](requireUrl.md) **New** | `String` | Renvoie la valeur en tant que une URL, ou lève une exception. | -| [`requireValidEmail`](requireValidEmail.md) | `String` | Renvoie la valeur en tant que une adresse e-mail, ou lève une exception. | -| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Renvoie la valeur en tant que un code de locale, ou lève une exception. | -| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Renvoie la valeur en tant que un slug, ou lève une exception. | -| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Renvoie la valeur en tant que une chaîne de version, ou lève une exception. | -| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Renvoie la version une fois l'exigence satisfaite, ou lève. | -| [`retry`](retry.md) **New** | `T` | Rappelle une fonction quand elle lève, avec une attente croissante entre les tentatives. | -| [`setPath`](setPath.md) **New** | `Object` | Écrit une propriété imbriquée par chemin, en créant ce qui manque. | -| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Chronomètre une suite de tâches nommées. | -| [`stringifyJson`](stringifyJson.md) | `String` | Sérialise une valeur en JSON avec un ordre de clés fixe. | -| [`toCamelCase`](toCamelCase.md) | `String` | Assemble les mots d'une chaîne en camelCase. | -| [`toInteger`](toInteger.md) | `Number \| null` | Extrait un nombre d'une valeur, ou signale qu'il n'y en a pas. | -| [`toKebabCase`](toKebabCase.md) | `String` | Réécrit une chaîne en kebab-case. | -| [`toLowerCase`](toLowerCase.md) | `String` | Met une chaîne en minuscules, en nettoyant au besoin ses espaces. | -| [`toProperCase`](toProperCase.md) | `String` | Met la première lettre de chaque mot en majuscule et le reste en minuscules. | -| [`toSnakeCase`](toSnakeCase.md) | `String` | Réécrit une chaîne en snake_case. | -| [`toUpperCase`](toUpperCase.md) | `String` | Met une chaîne en majuscules, en nettoyant au besoin ses espaces. | -| [`transpose`](transpose.md) | `Array` | Échange les lignes et les colonnes d'une matrice. | -| [`unique`](unique.md) **New** | `Array` | Retire les doublons d'un tableau en gardant la première occurrence de chaque valeur. | -| [`versionCompare`](versionCompare.md) | `Number` | Compare deux chaînes de version numériquement. | -| [`without`](without.md) **New** | `Array` | Retire d'un tableau toutes les occurrences des valeurs indiquées. | +| Fonction | Type de retour | Description brève | +| :--- | :--- | :--- | :--- | +| [`chunk`](chunk.md) | `Array` | Découpe un tableau en groupes consécutifs de taille fixe, en validant les deux arguments. | +| [`compact`](compact.md) **New** | `Array` | Retire toutes les valeurs falsy d'un tableau et affine le type des éléments sans cast. | +| [`decodeHtml`](decodeHtml.md) | `String` | Retransforme les références numériques en caractères. | +| [`diff`](diff.md) **New** | `Number` | Renvoie l'intervalle entre deux dates dans l'unité choisie. | +| [`encodeHtml`](encodeHtml.md) | `String` | Encode chaque caractère en référence numérique. | +| [`equals`](equals.md) **New** | `Boolean` | Compare deux valeurs en profondeur et sans risque avec null. | +| [`escapeHtml`](escapeHtml.md) | `String` | Remplace les cinq caractères qui seraient autrement lus comme du balisage. | +| [`escapeRegExp`](escapeRegExp.md) | `String` | Échappe les caractères qui ont un sens dans une expression régulière. | +| [`escapeXml`](escapeXml.md) | `String` | Échappe les caractères réservés par XML. | +| [`first`](first.md) **New** | `Any` | Prend le premier élément d'un tableau, ou ses n premiers éléments, sans test de vacuité. | +| [`flat`](flat.md) **New** | `Object` | Aplatit un objet imbriqué en un seul niveau de clés pointées. | +| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Renvoie le nombre de jours du mois d'une date. | +| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Renvoie combien de jours séparent une date de la fin de son mois. | +| [`getPath`](getPath.md) **New** | `Any` | Lit une propriété imbriquée par chemin, avec valeur de repli. | +| [`hashCode`](hashCode.md) | `Number` | Produit un condensé numérique pour n'importe quelle valeur. | +| [`intersect`](intersect.md) **New** | `Array` | Trouve les valeurs présentes dans chacun des tableaux fournis. | +| [`is2DArray`](is2DArray.md) | `Boolean` | Vérifie qu'une valeur est un tableau non vide dont chaque élément est lui-même un tableau. | +| [`isArray`](isArray.md) | `Boolean` | Vérifie si une valeur est un tableau. | +| [`isBoolean`](isBoolean.md) | `Boolean` | Vérifie si une valeur est un booléen. | +| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Vérifie qu'une valeur est une matrice non vide dont toutes les lignes ont la même longueur. | +| [`isCountable`](isCountable.md) | `Boolean` | Vérifie si une valeur est un nombre dénombrable. | +| [`isDouble`](isDouble.md) **New** | `Boolean` | Vérifie si une valeur est un nombre avec une partie fractionnaire. | +| [`isEmail`](isEmail.md) | `Boolean` | Vérifie si une valeur est une adresse e-mail. | +| [`isEmpty`](isEmpty.md) | `Boolean` | Vérifie si une valeur est vide. | +| [`isException`](isException.md) | `Boolean` | Vérifie si une valeur est une `Exception`. | +| [`isFloat`](isFloat.md) **New** | `Boolean` | Vérifie si une valeur est un nombre avec une partie fractionnaire. | +| [`isFunction`](isFunction.md) | `Boolean` | Vérifie si une valeur est une fonction. | +| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Vérifie si une valeur est appelable. | +| [`isInteger`](isInteger.md) | `Boolean` | Vérifie si une valeur est un entier. | +| [`isLength`](isLength.md) | `Boolean` | Vérifie si une valeur est une longueur de tableau valide. | +| [`isNaN`](isNaN.md) **New** | `Boolean` | Vérifie si une valeur est le nombre `NaN`. | +| [`isNil`](isNil.md) | `Boolean` | Vérifie si une valeur est `null` ou `undefined`. | +| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Vérifie si une valeur est un nombre non négatif. | +| [`isNull`](isNull.md) | `Boolean` | Vérifie si une valeur est `null`. | +| [`isNumber`](isNumber.md) | `Boolean` | Vérifie si une valeur est un nombre. | +| [`isNumberLike`](isNumberLike.md) | `Boolean` | Vérifie si une valeur est convertible en nombre. | +| [`isObject`](isObject.md) | `Boolean` | Vérifie si une valeur est un objet. | +| [`isObjectLike`](isObjectLike.md) | `Boolean` | Vérifie si une valeur est de type objet. | +| [`isRegExp`](isRegExp.md) | `Boolean` | Vérifie si une valeur est une expression régulière. | +| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Vérifie si une valeur est un entier sûr. | +| [`isScalar`](isScalar.md) | `Boolean` | Vérifie si une valeur est un scalaire. | +| [`isString`](isString.md) | `Boolean` | Vérifie si une valeur est une chaîne de caractères. | +| [`isSymbol`](isSymbol.md) | `Boolean` | Vérifie si une valeur est un symbole. | +| [`last`](last.md) **New** | `Any` | Prend le dernier élément d'un tableau, ou ses n derniers éléments dans leur ordre d'origine. | +| [`merge`](merge.md) **New** | `String` | Remplit les emplacements `{{ key }}` d'un gabarit depuis un objet. | +| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre avec une partie fractionnaire. | +| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Renvoie la valeur comme chaîne non vide, en nommant l'argument en cas d'échec. | +| [`isUndefined`](isUndefined.md) | `Boolean` | Vérifie si une valeur est `undefined`. | +| [`isUrl`](isUrl.md) | `Boolean` | Vérifie si une valeur est une URL. | +| [`isValidLocale`](isValidLocale.md) | `Boolean` | Vérifie si une valeur est un code de locale. | +| [`isValidSlug`](isValidSlug.md) | `Boolean` | Vérifie si une valeur est un slug. | +| [`isValidVersion`](isValidVersion.md) | `Boolean` | Vérifie si une valeur est une chaîne de version. | +| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Vérifie qu'une version atteint au moins celle requise. | +| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un tableau bidimensionnel non vide. | +| [`nonArray`](nonArray.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un tableau. | +| [`nonBoolean`](nonBoolean.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un booléen. | +| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une matrice dont les lignes ont toutes la même longueur. | +| [`nonEmpty`](nonEmpty.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** vide. | +| [`nonException`](nonException.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une `Exception`. | +| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre avec une partie fractionnaire. | +| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une fonction. | +| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre dénombrable. | +| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** appelable. | +| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un entier. | +| [`nonLength`](nonLength.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une longueur de tableau valide. | +| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** le nombre `NaN`. | +| [`nonNil`](nonNil.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** `null` ou `undefined`. | +| [`nonNull`](nonNull.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** `null`. | +| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Vérifie qu'une valeur est un nombre non négatif. | +| [`nonNumber`](nonNumber.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un nombre. | +| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** convertible en nombre. | +| [`nonObject`](nonObject.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un objet. | +| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** de type objet. | +| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une expression régulière. | +| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un entier sûr. | +| [`nonScalar`](nonScalar.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un scalaire. | +| [`nonString`](nonString.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** une chaîne de caractères. | +| [`nonSymbol`](nonSymbol.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** un symbole. | +| [`nonUndefined`](nonUndefined.md) | `Boolean` | Vérifie qu'une valeur n'est **pas** `undefined`. | +| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une URL. | +| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une adresse e-mail. | +| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un code de locale. | +| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** un slug. | +| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Vérifie qu'une valeur n'est **pas** une chaîne de version. | +| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Vérifie qu'une version reste en deçà de celle requise. | +| [`now`](now.md) | `Number` | Renvoie l'heure courante en millisecondes depuis l'époque. | +| [`ObjectTag`](ObjectTag.md) | `Enum` | Les tags internes qu'une valeur peut déclarer, sous forme de constantes nommées. | +| [`objectToString`](objectToString.md) | `String` | Renvoie le tag interne d'une valeur. | +| [`offset`](offset.md) **New** | `Date` | Décale une date d'un certain nombre d'unités. | +| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Analyse du JSON, puis réessaie avec un lecteur permissif si l'analyse stricte échoue. | +| [`require2DArray`](require2DArray.md) **New** | `Array` | Renvoie la valeur en tant que tableau bidimensionnel non vide, ou lève une exception. | +| [`requireArray`](requireArray.md) **New** | `Array` | Renvoie la valeur en tant que un tableau, ou lève une exception. | +| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Renvoie la valeur en tant que un booléen, ou lève une exception. | +| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Renvoie la valeur en tant que matrice à lignes de même longueur, ou lève en nommant la ligne fautive. | +| [`requireCountable`](requireCountable.md) **New** | `Number` | Renvoie la valeur en tant que un nombre dénombrable, ou lève une exception. | +| [`requireDouble`](requireDouble.md) **New** | `Number` | Renvoie la valeur en tant que un nombre avec une partie fractionnaire, ou lève une exception. | +| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Renvoie la valeur en tant que une valeur vide, ou lève une exception. | +| [`requireException`](requireException.md) **New** | `Exception` | Renvoie la valeur en tant que une `Exception`, ou lève une exception. | +| [`requireFloat`](requireFloat.md) **New** | `Number` | Renvoie la valeur en tant que un nombre avec une partie fractionnaire, ou lève une exception. | +| [`requireFunction`](requireFunction.md) **New** | `Function` | Renvoie la valeur en tant que une fonction, ou lève une exception. | +| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Renvoie la valeur en tant que une valeur appelable, ou lève une exception. | +| [`requireInteger`](requireInteger.md) **New** | `Number` | Renvoie la valeur en tant que un entier, ou lève une exception. | +| [`requireLength`](requireLength.md) **New** | `Number` | Renvoie la valeur en tant que une longueur de tableau valide, ou lève une exception. | +| [`requireNaN`](requireNaN.md) **New** | `Number` | Renvoie la valeur en tant que `NaN`, ou lève une exception. | +| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Renvoie la valeur en tant que `null` ou `undefined`, ou lève une exception. | +| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un tableau. | +| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un booléen. | +| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre avec une partie fractionnaire. | +| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas vide. | +| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre avec une partie fractionnaire. | +| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un entier. | +| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas le nombre `NaN`. | +| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un entier sûr. | +| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Renvoie la valeur en tant que un entier sûr, ou lève une exception. | +| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Renvoie la valeur en tant que un symbole, ou lève une exception. | +| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Renvoie la valeur comme une chaîne non vide, ou lève. | +| [`requireNonException`](requireNonException.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une `Exception`. | +| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une fonction. | +| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas appelable. | +| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Renvoie la collection inchangée après avoir vérifié qu'aucun élément n'est `null` ni `undefined`. | +| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une longueur de tableau valide. | +| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas `null` ou `undefined`. | +| [`requireNonNull`](requireNonNull.md) | `any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas `null` ou `undefined`. | +| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un nombre. | +| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas convertible en nombre. | +| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un objet. | +| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas de type objet. | +| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une expression régulière. | +| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un scalaire. | +| [`requireNonString`](requireNonString.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas une chaîne de caractères. | +| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas un symbole. | +| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Renvoie la valeur après avoir vérifié qu'elle n'est pas `undefined`. | +| [`requireNull`](requireNull.md) **New** | `Null` | Renvoie la valeur en tant que `null`, ou lève une exception. | +| [`requireNumber`](requireNumber.md) **New** | `Number` | Renvoie la valeur en tant que un nombre, ou lève une exception. | +| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Renvoie la valeur en tant que une valeur numérique, ou lève une exception. | +| [`requireObject`](requireObject.md) **New** | `Object` | Renvoie la valeur en tant que un objet, ou lève une exception. | +| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Renvoie la valeur en tant que une valeur de type objet, ou lève une exception. | +| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Renvoie la valeur en tant que une expression régulière, ou lève une exception. | +| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Renvoie la valeur en tant que un scalaire, ou lève une exception. | +| [`requireState`](requireState.md) **New** | `void` | Affirme qu'une condition tient, et lève dans le cas contraire. | +| [`requireString`](requireString.md) | `String` | Renvoie la valeur en tant que une chaîne de caractères, ou lève une exception. | +| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Renvoie la valeur en tant que `undefined`, ou lève une exception. | +| [`requireUrl`](requireUrl.md) **New** | `String` | Renvoie la valeur en tant que une URL, ou lève une exception. | +| [`requireValidEmail`](requireValidEmail.md) | `String` | Renvoie la valeur en tant que une adresse e-mail, ou lève une exception. | +| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Renvoie la valeur en tant que un code de locale, ou lève une exception. | +| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Renvoie la valeur en tant que un slug, ou lève une exception. | +| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Renvoie la valeur en tant que une chaîne de version, ou lève une exception. | +| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Renvoie la version une fois l'exigence satisfaite, ou lève. | +| [`retry`](retry.md) **New** | `T` | Rappelle une fonction quand elle lève, avec une attente croissante entre les tentatives. | +| [`setPath`](setPath.md) **New** | `Object` | Écrit une propriété imbriquée par chemin, en créant ce qui manque. | +| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Chronomètre une suite de tâches nommées. | +| [`stringifyJson`](stringifyJson.md) | `String` | Sérialise une valeur en JSON avec un ordre de clés fixe. | +| [`toCamelCase`](toCamelCase.md) | `String` | Assemble les mots d'une chaîne en camelCase. | +| [`toInteger`](toInteger.md) | `Number \| null` | Extrait un nombre d'une valeur, ou signale qu'il n'y en a pas. | +| [`toKebabCase`](toKebabCase.md) | `String` | Réécrit une chaîne en kebab-case. | +| [`toLowerCase`](toLowerCase.md) | `String` | Met une chaîne en minuscules, en nettoyant au besoin ses espaces. | +| [`toProperCase`](toProperCase.md) | `String` | Met la première lettre de chaque mot en majuscule et le reste en minuscules. | +| [`toSnakeCase`](toSnakeCase.md) | `String` | Réécrit une chaîne en snake_case. | +| [`toUpperCase`](toUpperCase.md) | `String` | Met une chaîne en majuscules, en nettoyant au besoin ses espaces. | +| [`transpose`](transpose.md) | `Array` | Échange les lignes et les colonnes d'une matrice. | +| [`unique`](unique.md) **New** | `Array` | Retire les doublons d'un tableau en gardant la première occurrence de chaque valeur. | +| [`versionCompare`](versionCompare.md) | `Number` | Compare deux chaînes de version numériquement. | +| [`without`](without.md) **New** | `Array` | Retire d'un tableau toutes les occurrences des valeurs indiquées. | diff --git a/docs/writerside-ru/topics/reference-base.md b/docs/writerside-ru/topics/reference-base.md index db8dacbc..90872f32 100644 --- a/docs/writerside-ru/topics/reference-base.md +++ b/docs/writerside-ru/topics/reference-base.md @@ -12,168 +12,168 @@ Пометка **New** означает функцию, добавленную в последнем выпуске; пометка **Deprecated** — функцию, которую планируется удалить в одном из будущих выпусков. -| Функция | Возвращает | Краткое описание | -| :---------------------------------------------------------------- | :--------------- | :------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------- | -| [`chunk`](chunk.md) | `Array` | Делит массив на последовательные группы фиксированного размера, проверяя оба аргумента. | -| [`compact`](compact.md) **New** | `Array` | Удаляет из массива все ложные значения и сужает тип элементов без приведения. | -| [`decodeHtml`](decodeHtml.md) | `String` | Превращает числовые ссылки на символы обратно в символы. | -| [`diff`](diff.md) **New** | `Number` | Возвращает интервал между двумя датами в выбранных единицах. | -| [`encodeHtml`](encodeHtml.md) | `String` | Кодирует каждый символ числовой ссылкой. | -| [`equals`](equals.md) **New** | `Boolean` | Сравнивает два значения вглубь и безопасно относительно null. | -| [`escapeHtml`](escapeHtml.md) | `String` | Заменяет пять символов, которые иначе были бы прочитаны как разметка. | -| [`escapeRegExp`](escapeRegExp.md) | `String` | Экранирует символы, которые имеют особое значение в регулярном выражении. | -| [`escapeXml`](escapeXml.md) | `String` | Экранирует символы, зарезервированные в XML. | -| [`first`](first.md) **New** | `Any` | Берёт первый элемент массива или его первые n элементов, без отдельной проверки на пустоту. | -| [`flat`](flat.md) **New** | `Object` | Разворачивает вложенный объект в один уровень с ключами через точку. | -| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Возвращает количество дней в месяце указанной даты. | -| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Возвращает, сколько дней остаётся от даты до конца её месяца. | -| [`getPath`](getPath.md) **New** | `Any` | Читает вложенное свойство по пути, с запасным значением. | -| [`hashCode`](hashCode.md) | `Number` | Вычисляет числовой хеш для любого значения. | -| [`intersect`](intersect.md) **New** | `Array` | Находит значения, присутствующие во всех переданных массивах. | -| [`is2DArray`](is2DArray.md) | `Boolean` | Проверяет, что значение — непустой массив, каждый элемент которого сам является массивом. | -| [`isArray`](isArray.md) | `Boolean` | Проверяет, является ли значение массивом. | -| [`isBoolean`](isBoolean.md) | `Boolean` | Проверяет, является ли значение логическим значением. | -| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Проверяет, что значение — непустая матрица, все строки которой одной длины. | -| [`isCountable`](isCountable.md) | `Boolean` | Проверяет, является ли значение счётным числом. | -| [`isDouble`](isDouble.md) **New** | `Boolean` | Проверяет, является ли значение числом с дробной частью. | -| [`isEmail`](isEmail.md) | `Boolean` | Проверяет, является ли значение адресом электронной почты. | -| [`isEmpty`](isEmpty.md) | `Boolean` | Проверяет, является ли значение пустым значением. | -| [`isException`](isException.md) | `Boolean` | Проверяет, является ли значение экземпляром `Exception`. | -| [`isFloat`](isFloat.md) **New** | `Boolean` | Проверяет, является ли значение числом с дробной частью. | -| [`isFunction`](isFunction.md) | `Boolean` | Проверяет, является ли значение функцией. | -| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Проверяет, является ли значение вызываемым значением. | -| [`isInteger`](isInteger.md) | `Boolean` | Проверяет, является ли значение целым числом. | -| [`isLength`](isLength.md) | `Boolean` | Проверяет, является ли значение допустимой длиной массива. | -| [`isNaN`](isNaN.md) **New** | `Boolean` | Проверяет, является ли значение числом `NaN`. | -| [`isNil`](isNil.md) | `Boolean` | Проверяет, является ли значение значением `null` или `undefined`. | -| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Проверяет, является ли значение неотрицательным числом. | -| [`isNull`](isNull.md) | `Boolean` | Проверяет, является ли значение значением `null`. | -| [`isNumber`](isNumber.md) | `Boolean` | Проверяет, является ли значение числом. | -| [`isNumberLike`](isNumberLike.md) | `Boolean` | Проверяет, является ли значение преобразуемым в число. | -| [`isObject`](isObject.md) | `Boolean` | Проверяет, является ли значение объектом. | -| [`isObjectLike`](isObjectLike.md) | `Boolean` | Проверяет, является ли значение объектоподобным значением. | -| [`isRegExp`](isRegExp.md) | `Boolean` | Проверяет, является ли значение регулярным выражением. | -| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Проверяет, является ли значение безопасным целым числом. | -| [`isScalar`](isScalar.md) | `Boolean` | Проверяет, является ли значение скалярным значением. | -| [`isString`](isString.md) | `Boolean` | Проверяет, является ли значение строкой. | -| [`isSymbol`](isSymbol.md) | `Boolean` | Проверяет, является ли значение символом. | -| [`last`](last.md) **New** | `Any` | Берёт последний элемент массива или его последние n элементов в исходном порядке. | -| [`merge`](merge.md) **New** | `String` | Подставляет значения объекта в плейсхолдеры `{{ key }}` шаблона. | -| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Проверяет, что значение **не** является числом с дробной частью. | -| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Возвращает значение как непустую строку, называя аргумент в сообщении об ошибке. | -| [`isUndefined`](isUndefined.md) | `Boolean` | Проверяет, является ли значение значением `undefined`. | -| [`isUrl`](isUrl.md) | `Boolean` | Проверяет, является ли значение URL-адресом. | -| [`isValidLocale`](isValidLocale.md) | `Boolean` | Проверяет, является ли значение кодом локали. | -| [`isValidSlug`](isValidSlug.md) | `Boolean` | Проверяет, является ли значение слагом. | -| [`isValidVersion`](isValidVersion.md) | `Boolean` | Проверяет, является ли значение строкой версии. | -| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Проверяет, что версия не ниже требуемой. | -| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Проверяет, что значение **не** является непустым двумерным массивом. | -| [`nonArray`](nonArray.md) | `Boolean` | Проверяет, что значение **не** является массивом. | -| [`nonBoolean`](nonBoolean.md) | `Boolean` | Проверяет, что значение **не** является логическим значением. | -| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Проверяет, что значение **не** является двумерным массивом с одинаковой длиной строк. | -| [`nonEmpty`](nonEmpty.md) | `Boolean` | Проверяет, что значение **не** является пустым значением. | -| [`nonException`](nonException.md) **New** | `Boolean` | Проверяет, что значение **не** является экземпляром `Exception`. | -| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Проверяет, что значение **не** является числом с дробной частью. | -| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Проверяет, что значение **не** является функцией. | -| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Проверяет, что значение **не** является счётным числом. | -| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Проверяет, что значение **не** является вызываемым значением. | -| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Проверяет, что значение **не** является целым числом. | -| [`nonLength`](nonLength.md) **New** | `Boolean` | Проверяет, что значение **не** является допустимой длиной массива. | -| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Проверяет, что значение **не** является числом `NaN`. | -| [`nonNil`](nonNil.md) | `Boolean` | Проверяет, что значение **не** является значением `null` или `undefined`. | -| [`nonNull`](nonNull.md) | `Boolean` | Проверяет, что значение **не** является значением `null`. | -| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Проверяет, что значение — неотрицательное число. | -| [`nonNumber`](nonNumber.md) | `Boolean` | Проверяет, что значение **не** является числом. | -| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Проверяет, что значение **не** является преобразуемым в число. | -| [`nonObject`](nonObject.md) **New** | `Boolean` | Проверяет, что значение **не** является объектом. | -| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Проверяет, что значение **не** является объектоподобным значением. | -| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Проверяет, что значение **не** является регулярным выражением. | -| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Проверяет, что значение **не** является безопасным целым числом. | -| [`nonScalar`](nonScalar.md) | `Boolean` | Проверяет, что значение **не** является скалярным значением. | -| [`nonString`](nonString.md) | `Boolean` | Проверяет, что значение **не** является строкой. | -| [`nonSymbol`](nonSymbol.md) | `Boolean` | Проверяет, что значение **не** является символом. | -| [`nonUndefined`](nonUndefined.md) | `Boolean` | Проверяет, что значение **не** является значением `undefined`. | -| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Проверяет, что значение **не** является URL-адресом. | -| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Проверяет, что значение **не** является адресом электронной почты. | -| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Проверяет, что значение **не** является кодом локали. | -| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Проверяет, что значение **не** является слагом. | -| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Проверяет, что значение **не** является строкой версии. | -| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Проверяет, что версия ниже требуемой. | -| [`now`](now.md) | `Number` | Возвращает текущее время в миллисекундах с начала эпохи. | -| [`ObjectTag`](ObjectTag.md) | `Enum` | Внутренние теги, которые может сообщить значение, в виде именованных констант. | -| [`objectToString`](objectToString.md) | `String` | Возвращает внутренний тег значения. | -| [`offset`](offset.md) **New** | `Date` | Сдвигает дату на заданное количество единиц. | -| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Разбирает JSON, а при неудаче строгого разбора пробует нестрогий. | -| [`require2DArray`](require2DArray.md) **New** | `Array` | Возвращает значение как непустой двумерный массив или выбрасывает исключение. | -| [`requireArray`](requireArray.md) **New** | `Array` | Возвращает значение как массив или выбрасывает исключение. | -| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Возвращает значение как логическое значение или выбрасывает исключение. | -| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Возвращает значение как двумерный массив с одинаковой длиной строк или выбрасывает исключение. | -| [`requireCountable`](requireCountable.md) **New** | `Number` | Возвращает значение как счётное число или выбрасывает исключение. | -| [`requireDouble`](requireDouble.md) **New** | `Number` | Возвращает значение как число с дробной частью или выбрасывает исключение. | -| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Возвращает значение как пустое значение или выбрасывает исключение. | -| [`requireException`](requireException.md) **New** | `Exception` | Возвращает значение как `Exception` или выбрасывает исключение. | -| [`requireFloat`](requireFloat.md) **New** | `Number` | Возвращает значение как число с дробной частью или выбрасывает исключение. | -| [`requireFunction`](requireFunction.md) **New** | `Function` | Возвращает значение как функцию или выбрасывает исключение. | -| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Возвращает значение как вызываемое значение или выбрасывает исключение. | -| [`requireInteger`](requireInteger.md) **New** | `Number` | Возвращает значение как целое число или выбрасывает исключение. | -| [`requireLength`](requireLength.md) **New** | `Number` | Возвращает значение как допустимую длину массива или выбрасывает исключение. | -| [`requireNaN`](requireNaN.md) **New** | `Number` | Возвращает значение как `NaN` или выбрасывает исключение. | -| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Возвращает значение как `null` или `undefined` или выбрасывает исключение. | -| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является массивом. | -| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является логическим значением. | -| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом с дробной частью. | -| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является пустым значением. | -| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом с дробной частью. | -| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является целым числом. | -| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом `NaN`. | -| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является безопасным целым числом. | -| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Возвращает значение как безопасное целое число или выбрасывает исключение. | -| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Возвращает значение как символ или выбрасывает исключение. | -| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Возвращает значение как непустую строку или бросает исключение. | -| [`requireNonException`](requireNonException.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является экземпляром `Exception`. | -| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является функцией. | -| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является вызываемым значением. | -| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Возвращает коллекцию без изменений, убедившись, что ни один её элемент не равен `null` или `undefined`. | -| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является допустимой длиной массива. | -| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является значением `null` или `undefined`. | -| [`requireNonNull`](requireNonNull.md) | `any` | Возвращает значение, убедившись, что оно не является значением `null` или `undefined`. | -| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом. | -| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является преобразуемым в число. | -| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является объектом. | -| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является объектоподобным значением. | -| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является регулярным выражением. | -| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является скалярным значением. | -| [`requireNonString`](requireNonString.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является строкой. | -| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является символом. | -| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является значением `undefined`. | -| [`requireNull`](requireNull.md) **New** | `Null` | Возвращает значение как `null` или выбрасывает исключение. | -| [`requireNumber`](requireNumber.md) **New** | `Number` | Возвращает значение как число или выбрасывает исключение. | -| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Возвращает значение как числовое значение или выбрасывает исключение. | -| [`requireObject`](requireObject.md) **New** | `Object` | Возвращает значение как объект или выбрасывает исключение. | -| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Возвращает значение как объектоподобное значение или выбрасывает исключение. | -| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Возвращает значение как регулярное выражение или выбрасывает исключение. | -| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Возвращает значение как скалярное значение или выбрасывает исключение. | -| [`requireState`](requireState.md) **New** | `void` | Утверждает, что условие выполняется, и бросает исключение, если нет. | -| [`requireString`](requireString.md) | `String` | Возвращает значение как строку или выбрасывает исключение. | -| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Возвращает значение как `undefined` или выбрасывает исключение. | -| [`requireUrl`](requireUrl.md) **New** | `String` | Возвращает значение как URL-адрес или выбрасывает исключение. | -| [`requireValidEmail`](requireValidEmail.md) | `String` | Возвращает значение как адрес электронной почты или выбрасывает исключение. | -| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Возвращает значение как код локали или выбрасывает исключение. | -| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Возвращает значение как слаг или выбрасывает исключение. | -| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Возвращает значение как строку версии или выбрасывает исключение. | -| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Возвращает версию, убедившись, что она удовлетворяет требованию, иначе бросает исключение. | -| [`retry`](retry.md) **New** | `T` | Повторяет вызов функции при исключении, увеличивая паузу между попытками. | -| [`setPath`](setPath.md) **New** | `Object` | Записывает вложенное свойство по пути, создавая недостающее. | -| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Измеряет время последовательности именованных задач. | -| [`stringifyJson`](stringifyJson.md) | `String` | Сериализует значение в JSON с фиксированным порядком ключей. | -| [`toCamelCase`](toCamelCase.md) | `String` | Склеивает слова строки в camelCase. | -| [`toInteger`](toInteger.md) | `Number \| null` | Извлекает число из значения или сообщает, что числа нет. | -| [`toKebabCase`](toKebabCase.md) | `String` | Переписывает строку в kebab-case. | -| [`toLowerCase`](toLowerCase.md) | `String` | Приводит строку к нижнему регистру, при желании прибирая пробелы. | -| [`toProperCase`](toProperCase.md) | `String` | Делает первую букву каждого слова заглавной, а остальные строчными. | -| [`toSnakeCase`](toSnakeCase.md) | `String` | Переписывает строку в snake_case. | -| [`toUpperCase`](toUpperCase.md) | `String` | Приводит строку к верхнему регистру, при желании прибирая пробелы. | -| [`transpose`](transpose.md) | `Array` | Меняет местами строки и столбцы матрицы. | -| [`unique`](unique.md) **New** | `Array` | Удаляет из массива повторы, сохраняя первое вхождение каждого значения. | -| [`versionCompare`](versionCompare.md) | `Number` | Сравнивает две строки версий по числам. | -| [`without`](without.md) **New** | `Array` | Удаляет из массива все вхождения перечисленных значений. | +| Функция | Возвращает | Краткое описание | +| :--- | :--- | :--- | :--- | +| [`chunk`](chunk.md) | `Array` | Делит массив на последовательные группы фиксированного размера, проверяя оба аргумента. | +| [`compact`](compact.md) **New** | `Array` | Удаляет из массива все ложные значения и сужает тип элементов без приведения. | +| [`decodeHtml`](decodeHtml.md) | `String` | Превращает числовые ссылки на символы обратно в символы. | +| [`diff`](diff.md) **New** | `Number` | Возвращает интервал между двумя датами в выбранных единицах. | +| [`encodeHtml`](encodeHtml.md) | `String` | Кодирует каждый символ числовой ссылкой. | +| [`equals`](equals.md) **New** | `Boolean` | Сравнивает два значения вглубь и безопасно относительно null. | +| [`escapeHtml`](escapeHtml.md) | `String` | Заменяет пять символов, которые иначе были бы прочитаны как разметка. | +| [`escapeRegExp`](escapeRegExp.md) | `String` | Экранирует символы, которые имеют особое значение в регулярном выражении. | +| [`escapeXml`](escapeXml.md) | `String` | Экранирует символы, зарезервированные в XML. | +| [`first`](first.md) **New** | `Any` | Берёт первый элемент массива или его первые n элементов, без отдельной проверки на пустоту. | +| [`flat`](flat.md) **New** | `Object` | Разворачивает вложенный объект в один уровень с ключами через точку. | +| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Возвращает количество дней в месяце указанной даты. | +| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Возвращает, сколько дней остаётся от даты до конца её месяца. | +| [`getPath`](getPath.md) **New** | `Any` | Читает вложенное свойство по пути, с запасным значением. | +| [`hashCode`](hashCode.md) | `Number` | Вычисляет числовой хеш для любого значения. | +| [`intersect`](intersect.md) **New** | `Array` | Находит значения, присутствующие во всех переданных массивах. | +| [`is2DArray`](is2DArray.md) | `Boolean` | Проверяет, что значение — непустой массив, каждый элемент которого сам является массивом. | +| [`isArray`](isArray.md) | `Boolean` | Проверяет, является ли значение массивом. | +| [`isBoolean`](isBoolean.md) | `Boolean` | Проверяет, является ли значение логическим значением. | +| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Проверяет, что значение — непустая матрица, все строки которой одной длины. | +| [`isCountable`](isCountable.md) | `Boolean` | Проверяет, является ли значение счётным числом. | +| [`isDouble`](isDouble.md) **New** | `Boolean` | Проверяет, является ли значение числом с дробной частью. | +| [`isEmail`](isEmail.md) | `Boolean` | Проверяет, является ли значение адресом электронной почты. | +| [`isEmpty`](isEmpty.md) | `Boolean` | Проверяет, является ли значение пустым значением. | +| [`isException`](isException.md) | `Boolean` | Проверяет, является ли значение экземпляром `Exception`. | +| [`isFloat`](isFloat.md) **New** | `Boolean` | Проверяет, является ли значение числом с дробной частью. | +| [`isFunction`](isFunction.md) | `Boolean` | Проверяет, является ли значение функцией. | +| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Проверяет, является ли значение вызываемым значением. | +| [`isInteger`](isInteger.md) | `Boolean` | Проверяет, является ли значение целым числом. | +| [`isLength`](isLength.md) | `Boolean` | Проверяет, является ли значение допустимой длиной массива. | +| [`isNaN`](isNaN.md) **New** | `Boolean` | Проверяет, является ли значение числом `NaN`. | +| [`isNil`](isNil.md) | `Boolean` | Проверяет, является ли значение значением `null` или `undefined`. | +| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Проверяет, является ли значение неотрицательным числом. | +| [`isNull`](isNull.md) | `Boolean` | Проверяет, является ли значение значением `null`. | +| [`isNumber`](isNumber.md) | `Boolean` | Проверяет, является ли значение числом. | +| [`isNumberLike`](isNumberLike.md) | `Boolean` | Проверяет, является ли значение преобразуемым в число. | +| [`isObject`](isObject.md) | `Boolean` | Проверяет, является ли значение объектом. | +| [`isObjectLike`](isObjectLike.md) | `Boolean` | Проверяет, является ли значение объектоподобным значением. | +| [`isRegExp`](isRegExp.md) | `Boolean` | Проверяет, является ли значение регулярным выражением. | +| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Проверяет, является ли значение безопасным целым числом. | +| [`isScalar`](isScalar.md) | `Boolean` | Проверяет, является ли значение скалярным значением. | +| [`isString`](isString.md) | `Boolean` | Проверяет, является ли значение строкой. | +| [`isSymbol`](isSymbol.md) | `Boolean` | Проверяет, является ли значение символом. | +| [`last`](last.md) **New** | `Any` | Берёт последний элемент массива или его последние n элементов в исходном порядке. | +| [`merge`](merge.md) **New** | `String` | Подставляет значения объекта в плейсхолдеры `{{ key }}` шаблона. | +| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Проверяет, что значение **не** является числом с дробной частью. | +| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Возвращает значение как непустую строку, называя аргумент в сообщении об ошибке. | +| [`isUndefined`](isUndefined.md) | `Boolean` | Проверяет, является ли значение значением `undefined`. | +| [`isUrl`](isUrl.md) | `Boolean` | Проверяет, является ли значение URL-адресом. | +| [`isValidLocale`](isValidLocale.md) | `Boolean` | Проверяет, является ли значение кодом локали. | +| [`isValidSlug`](isValidSlug.md) | `Boolean` | Проверяет, является ли значение слагом. | +| [`isValidVersion`](isValidVersion.md) | `Boolean` | Проверяет, является ли значение строкой версии. | +| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Проверяет, что версия не ниже требуемой. | +| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Проверяет, что значение **не** является непустым двумерным массивом. | +| [`nonArray`](nonArray.md) | `Boolean` | Проверяет, что значение **не** является массивом. | +| [`nonBoolean`](nonBoolean.md) | `Boolean` | Проверяет, что значение **не** является логическим значением. | +| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Проверяет, что значение **не** является двумерным массивом с одинаковой длиной строк. | +| [`nonEmpty`](nonEmpty.md) | `Boolean` | Проверяет, что значение **не** является пустым значением. | +| [`nonException`](nonException.md) **New** | `Boolean` | Проверяет, что значение **не** является экземпляром `Exception`. | +| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Проверяет, что значение **не** является числом с дробной частью. | +| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Проверяет, что значение **не** является функцией. | +| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Проверяет, что значение **не** является счётным числом. | +| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Проверяет, что значение **не** является вызываемым значением. | +| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Проверяет, что значение **не** является целым числом. | +| [`nonLength`](nonLength.md) **New** | `Boolean` | Проверяет, что значение **не** является допустимой длиной массива. | +| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Проверяет, что значение **не** является числом `NaN`. | +| [`nonNil`](nonNil.md) | `Boolean` | Проверяет, что значение **не** является значением `null` или `undefined`. | +| [`nonNull`](nonNull.md) | `Boolean` | Проверяет, что значение **не** является значением `null`. | +| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Проверяет, что значение — неотрицательное число. | +| [`nonNumber`](nonNumber.md) | `Boolean` | Проверяет, что значение **не** является числом. | +| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Проверяет, что значение **не** является преобразуемым в число. | +| [`nonObject`](nonObject.md) **New** | `Boolean` | Проверяет, что значение **не** является объектом. | +| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Проверяет, что значение **не** является объектоподобным значением. | +| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Проверяет, что значение **не** является регулярным выражением. | +| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Проверяет, что значение **не** является безопасным целым числом. | +| [`nonScalar`](nonScalar.md) | `Boolean` | Проверяет, что значение **не** является скалярным значением. | +| [`nonString`](nonString.md) | `Boolean` | Проверяет, что значение **не** является строкой. | +| [`nonSymbol`](nonSymbol.md) | `Boolean` | Проверяет, что значение **не** является символом. | +| [`nonUndefined`](nonUndefined.md) | `Boolean` | Проверяет, что значение **не** является значением `undefined`. | +| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Проверяет, что значение **не** является URL-адресом. | +| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Проверяет, что значение **не** является адресом электронной почты. | +| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Проверяет, что значение **не** является кодом локали. | +| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Проверяет, что значение **не** является слагом. | +| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Проверяет, что значение **не** является строкой версии. | +| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Проверяет, что версия ниже требуемой. | +| [`now`](now.md) | `Number` | Возвращает текущее время в миллисекундах с начала эпохи. | +| [`ObjectTag`](ObjectTag.md) | `Enum` | Внутренние теги, которые может сообщить значение, в виде именованных констант. | +| [`objectToString`](objectToString.md) | `String` | Возвращает внутренний тег значения. | +| [`offset`](offset.md) **New** | `Date` | Сдвигает дату на заданное количество единиц. | +| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Разбирает JSON, а при неудаче строгого разбора пробует нестрогий. | +| [`require2DArray`](require2DArray.md) **New** | `Array` | Возвращает значение как непустой двумерный массив или выбрасывает исключение. | +| [`requireArray`](requireArray.md) **New** | `Array` | Возвращает значение как массив или выбрасывает исключение. | +| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Возвращает значение как логическое значение или выбрасывает исключение. | +| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Возвращает значение как двумерный массив с одинаковой длиной строк или выбрасывает исключение. | +| [`requireCountable`](requireCountable.md) **New** | `Number` | Возвращает значение как счётное число или выбрасывает исключение. | +| [`requireDouble`](requireDouble.md) **New** | `Number` | Возвращает значение как число с дробной частью или выбрасывает исключение. | +| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Возвращает значение как пустое значение или выбрасывает исключение. | +| [`requireException`](requireException.md) **New** | `Exception` | Возвращает значение как `Exception` или выбрасывает исключение. | +| [`requireFloat`](requireFloat.md) **New** | `Number` | Возвращает значение как число с дробной частью или выбрасывает исключение. | +| [`requireFunction`](requireFunction.md) **New** | `Function` | Возвращает значение как функцию или выбрасывает исключение. | +| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Возвращает значение как вызываемое значение или выбрасывает исключение. | +| [`requireInteger`](requireInteger.md) **New** | `Number` | Возвращает значение как целое число или выбрасывает исключение. | +| [`requireLength`](requireLength.md) **New** | `Number` | Возвращает значение как допустимую длину массива или выбрасывает исключение. | +| [`requireNaN`](requireNaN.md) **New** | `Number` | Возвращает значение как `NaN` или выбрасывает исключение. | +| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Возвращает значение как `null` или `undefined` или выбрасывает исключение. | +| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является массивом. | +| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является логическим значением. | +| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом с дробной частью. | +| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является пустым значением. | +| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом с дробной частью. | +| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является целым числом. | +| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом `NaN`. | +| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является безопасным целым числом. | +| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Возвращает значение как безопасное целое число или выбрасывает исключение. | +| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Возвращает значение как символ или выбрасывает исключение. | +| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Возвращает значение как непустую строку или бросает исключение. | +| [`requireNonException`](requireNonException.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является экземпляром `Exception`. | +| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является функцией. | +| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является вызываемым значением. | +| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Возвращает коллекцию без изменений, убедившись, что ни один её элемент не равен `null` или `undefined`. | +| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является допустимой длиной массива. | +| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является значением `null` или `undefined`. | +| [`requireNonNull`](requireNonNull.md) | `any` | Возвращает значение, убедившись, что оно не является значением `null` или `undefined`. | +| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является числом. | +| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является преобразуемым в число. | +| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является объектом. | +| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является объектоподобным значением. | +| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является регулярным выражением. | +| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является скалярным значением. | +| [`requireNonString`](requireNonString.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является строкой. | +| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является символом. | +| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Возвращает значение, убедившись, что оно не является значением `undefined`. | +| [`requireNull`](requireNull.md) **New** | `Null` | Возвращает значение как `null` или выбрасывает исключение. | +| [`requireNumber`](requireNumber.md) **New** | `Number` | Возвращает значение как число или выбрасывает исключение. | +| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Возвращает значение как числовое значение или выбрасывает исключение. | +| [`requireObject`](requireObject.md) **New** | `Object` | Возвращает значение как объект или выбрасывает исключение. | +| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Возвращает значение как объектоподобное значение или выбрасывает исключение. | +| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Возвращает значение как регулярное выражение или выбрасывает исключение. | +| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Возвращает значение как скалярное значение или выбрасывает исключение. | +| [`requireState`](requireState.md) **New** | `void` | Утверждает, что условие выполняется, и бросает исключение, если нет. | +| [`requireString`](requireString.md) | `String` | Возвращает значение как строку или выбрасывает исключение. | +| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Возвращает значение как `undefined` или выбрасывает исключение. | +| [`requireUrl`](requireUrl.md) **New** | `String` | Возвращает значение как URL-адрес или выбрасывает исключение. | +| [`requireValidEmail`](requireValidEmail.md) | `String` | Возвращает значение как адрес электронной почты или выбрасывает исключение. | +| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Возвращает значение как код локали или выбрасывает исключение. | +| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Возвращает значение как слаг или выбрасывает исключение. | +| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Возвращает значение как строку версии или выбрасывает исключение. | +| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Возвращает версию, убедившись, что она удовлетворяет требованию, иначе бросает исключение. | +| [`retry`](retry.md) **New** | `T` | Повторяет вызов функции при исключении, увеличивая паузу между попытками. | +| [`setPath`](setPath.md) **New** | `Object` | Записывает вложенное свойство по пути, создавая недостающее. | +| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Измеряет время последовательности именованных задач. | +| [`stringifyJson`](stringifyJson.md) | `String` | Сериализует значение в JSON с фиксированным порядком ключей. | +| [`toCamelCase`](toCamelCase.md) | `String` | Склеивает слова строки в camelCase. | +| [`toInteger`](toInteger.md) | `Number \| null` | Извлекает число из значения или сообщает, что числа нет. | +| [`toKebabCase`](toKebabCase.md) | `String` | Переписывает строку в kebab-case. | +| [`toLowerCase`](toLowerCase.md) | `String` | Приводит строку к нижнему регистру, при желании прибирая пробелы. | +| [`toProperCase`](toProperCase.md) | `String` | Делает первую букву каждого слова заглавной, а остальные строчными. | +| [`toSnakeCase`](toSnakeCase.md) | `String` | Переписывает строку в snake_case. | +| [`toUpperCase`](toUpperCase.md) | `String` | Приводит строку к верхнему регистру, при желании прибирая пробелы. | +| [`transpose`](transpose.md) | `Array` | Меняет местами строки и столбцы матрицы. | +| [`unique`](unique.md) **New** | `Array` | Удаляет из массива повторы, сохраняя первое вхождение каждого значения. | +| [`versionCompare`](versionCompare.md) | `Number` | Сравнивает две строки версий по числам. | +| [`without`](without.md) **New** | `Array` | Удаляет из массива все вхождения перечисленных значений. | diff --git a/docs/writerside-uk/topics/reference-base.md b/docs/writerside-uk/topics/reference-base.md index e56e29e0..8859a093 100644 --- a/docs/writerside-uk/topics/reference-base.md +++ b/docs/writerside-uk/topics/reference-base.md @@ -12,168 +12,168 @@ Позначка **New** означає функцію, додану в останньому випуску; позначка **Deprecated** — функцію, яку планується вилучити в одному з майбутніх випусків. -| Функція | Повертає | Короткий опис | -| :---------------------------------------------------------------- | :--------------- | :------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------- | -| [`chunk`](chunk.md) | `Array` | Ділить масив на послідовні групи фіксованого розміру, перевіряючи обидва аргументи. | -| [`compact`](compact.md) **New** | `Array` | Видаляє з масиву всі хибні значення та звужує тип елементів без приведення. | -| [`decodeHtml`](decodeHtml.md) | `String` | Перетворює числові посилання на символи назад у символи. | -| [`diff`](diff.md) **New** | `Number` | Повертає інтервал між двома датами у вибраних одиницях. | -| [`encodeHtml`](encodeHtml.md) | `String` | Кодує кожен символ числовим посиланням. | -| [`equals`](equals.md) **New** | `Boolean` | Порівнює два значення вглиб і безпечно щодо null. | -| [`escapeHtml`](escapeHtml.md) | `String` | Замінює п'ять символів, які інакше були б прочитані як розмітка. | -| [`escapeRegExp`](escapeRegExp.md) | `String` | Екранує символи, що мають особливе значення в регулярному виразі. | -| [`escapeXml`](escapeXml.md) | `String` | Екранує символи, зарезервовані в XML. | -| [`first`](first.md) **New** | `Any` | Бере перший елемент масиву або його перші n елементів, без окремої перевірки на порожність. | -| [`flat`](flat.md) **New** | `Object` | Розгортає вкладений об'єкт в один рівень з ключами через крапку. | -| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Повертає кількість днів у місяці вказаної дати. | -| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Повертає, скільки днів лишається від дати до кінця її місяця. | -| [`getPath`](getPath.md) **New** | `Any` | Читає вкладену властивість за шляхом, із запасним значенням. | -| [`hashCode`](hashCode.md) | `Number` | Обчислює числовий хеш для будь-якого значення. | -| [`intersect`](intersect.md) **New** | `Array` | Знаходить значення, наявні в усіх переданих масивах. | -| [`is2DArray`](is2DArray.md) | `Boolean` | Перевіряє, що значення — непорожній масив, кожен елемент якого сам є масивом. | -| [`isArray`](isArray.md) | `Boolean` | Перевіряє, чи є значення масивом. | -| [`isBoolean`](isBoolean.md) | `Boolean` | Перевіряє, чи є значення логічним значенням. | -| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Перевіряє, що значення — непорожня матриця, усі рядки якої однакової довжини. | -| [`isCountable`](isCountable.md) | `Boolean` | Перевіряє, чи є значення лічильним числом. | -| [`isDouble`](isDouble.md) **New** | `Boolean` | Перевіряє, чи є значення числом з дробовою частиною. | -| [`isEmail`](isEmail.md) | `Boolean` | Перевіряє, чи є значення адресою електронної пошти. | -| [`isEmpty`](isEmpty.md) | `Boolean` | Перевіряє, чи є значення порожнім значенням. | -| [`isException`](isException.md) | `Boolean` | Перевіряє, чи є значення екземпляром `Exception`. | -| [`isFloat`](isFloat.md) **New** | `Boolean` | Перевіряє, чи є значення числом з дробовою частиною. | -| [`isFunction`](isFunction.md) | `Boolean` | Перевіряє, чи є значення функцією. | -| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Перевіряє, чи є значення викликаним значенням. | -| [`isInteger`](isInteger.md) | `Boolean` | Перевіряє, чи є значення цілим числом. | -| [`isLength`](isLength.md) | `Boolean` | Перевіряє, чи є значення припустимою довжиною масиву. | -| [`isNaN`](isNaN.md) **New** | `Boolean` | Перевіряє, чи є значення числом `NaN`. | -| [`isNil`](isNil.md) | `Boolean` | Перевіряє, чи є значення значенням `null` або `undefined`. | -| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Перевіряє, чи є значення невід'ємним числом. | -| [`isNull`](isNull.md) | `Boolean` | Перевіряє, чи є значення значенням `null`. | -| [`isNumber`](isNumber.md) | `Boolean` | Перевіряє, чи є значення числом. | -| [`isNumberLike`](isNumberLike.md) | `Boolean` | Перевіряє, чи є значення перетворюваним на число. | -| [`isObject`](isObject.md) | `Boolean` | Перевіряє, чи є значення об'єктом. | -| [`isObjectLike`](isObjectLike.md) | `Boolean` | Перевіряє, чи є значення об'єктоподібним значенням. | -| [`isRegExp`](isRegExp.md) | `Boolean` | Перевіряє, чи є значення регулярним виразом. | -| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Перевіряє, чи є значення безпечним цілим числом. | -| [`isScalar`](isScalar.md) | `Boolean` | Перевіряє, чи є значення скалярним значенням. | -| [`isString`](isString.md) | `Boolean` | Перевіряє, чи є значення рядком. | -| [`isSymbol`](isSymbol.md) | `Boolean` | Перевіряє, чи є значення символом. | -| [`last`](last.md) **New** | `Any` | Бере останній елемент масиву або його останні n елементів у початковому порядку. | -| [`merge`](merge.md) **New** | `String` | Підставляє значення об'єкта в плейсхолдери `{{ key }}` шаблону. | -| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Перевіряє, що значення **не** є числом з дробовою частиною. | -| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Повертає значення як непорожній рядок, називаючи аргумент у повідомленні про помилку. | -| [`isUndefined`](isUndefined.md) | `Boolean` | Перевіряє, чи є значення значенням `undefined`. | -| [`isUrl`](isUrl.md) | `Boolean` | Перевіряє, чи є значення URL-адресою. | -| [`isValidLocale`](isValidLocale.md) | `Boolean` | Перевіряє, чи є значення кодом локалі. | -| [`isValidSlug`](isValidSlug.md) | `Boolean` | Перевіряє, чи є значення слагом. | -| [`isValidVersion`](isValidVersion.md) | `Boolean` | Перевіряє, чи є значення рядком версії. | -| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Перевіряє, що версія не нижча за потрібну. | -| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Перевіряє, що значення **не** є непорожнім двовимірним масивом. | -| [`nonArray`](nonArray.md) | `Boolean` | Перевіряє, що значення **не** є масивом. | -| [`nonBoolean`](nonBoolean.md) | `Boolean` | Перевіряє, що значення **не** є логічним значенням. | -| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Перевіряє, що значення **не** є двовимірним масивом з однаковою довжиною рядків. | -| [`nonEmpty`](nonEmpty.md) | `Boolean` | Перевіряє, що значення **не** є порожнім значенням. | -| [`nonException`](nonException.md) **New** | `Boolean` | Перевіряє, що значення **не** є екземпляром `Exception`. | -| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Перевіряє, що значення **не** є числом з дробовою частиною. | -| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Перевіряє, що значення **не** є функцією. | -| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Перевіряє, що значення **не** є лічильним числом. | -| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Перевіряє, що значення **не** є викликаним значенням. | -| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Перевіряє, що значення **не** є цілим числом. | -| [`nonLength`](nonLength.md) **New** | `Boolean` | Перевіряє, що значення **не** є припустимою довжиною масиву. | -| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Перевіряє, що значення **не** є числом `NaN`. | -| [`nonNil`](nonNil.md) | `Boolean` | Перевіряє, що значення **не** є значенням `null` або `undefined`. | -| [`nonNull`](nonNull.md) | `Boolean` | Перевіряє, що значення **не** є значенням `null`. | -| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Перевіряє, що значення — невід'ємне число. | -| [`nonNumber`](nonNumber.md) | `Boolean` | Перевіряє, що значення **не** є числом. | -| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Перевіряє, що значення **не** є перетворюваним на число. | -| [`nonObject`](nonObject.md) **New** | `Boolean` | Перевіряє, що значення **не** є об'єктом. | -| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Перевіряє, що значення **не** є об'єктоподібним значенням. | -| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Перевіряє, що значення **не** є регулярним виразом. | -| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Перевіряє, що значення **не** є безпечним цілим числом. | -| [`nonScalar`](nonScalar.md) | `Boolean` | Перевіряє, що значення **не** є скалярним значенням. | -| [`nonString`](nonString.md) | `Boolean` | Перевіряє, що значення **не** є рядком. | -| [`nonSymbol`](nonSymbol.md) | `Boolean` | Перевіряє, що значення **не** є символом. | -| [`nonUndefined`](nonUndefined.md) | `Boolean` | Перевіряє, що значення **не** є значенням `undefined`. | -| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Перевіряє, що значення **не** є URL-адресою. | -| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Перевіряє, що значення **не** є адресою електронної пошти. | -| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Перевіряє, що значення **не** є кодом локалі. | -| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Перевіряє, що значення **не** є слагом. | -| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Перевіряє, що значення **не** є рядком версії. | -| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Перевіряє, що версія нижча за потрібну. | -| [`now`](now.md) | `Number` | Повертає поточний час у мілісекундах від початку епохи. | -| [`ObjectTag`](ObjectTag.md) | `Enum` | Внутрішні теги, які може повідомити значення, у вигляді іменованих констант. | -| [`objectToString`](objectToString.md) | `String` | Повертає внутрішній тег значення. | -| [`offset`](offset.md) **New** | `Date` | Зсуває дату на задану кількість одиниць. | -| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Розбирає JSON, а при невдачі суворого розбору пробує нестрогий. | -| [`require2DArray`](require2DArray.md) **New** | `Array` | Повертає значення як непорожній двовимірний масив або викидає виняток. | -| [`requireArray`](requireArray.md) **New** | `Array` | Повертає значення як масив або викидає виняток. | -| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Повертає значення як логічне значення або викидає виняток. | -| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Повертає значення як двовимірний масив з однаковою довжиною рядків або викидає виняток. | -| [`requireCountable`](requireCountable.md) **New** | `Number` | Повертає значення як лічильне число або викидає виняток. | -| [`requireDouble`](requireDouble.md) **New** | `Number` | Повертає значення як число з дробовою частиною або викидає виняток. | -| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Повертає значення як порожнє значення або викидає виняток. | -| [`requireException`](requireException.md) **New** | `Exception` | Повертає значення як `Exception` або викидає виняток. | -| [`requireFloat`](requireFloat.md) **New** | `Number` | Повертає значення як число з дробовою частиною або викидає виняток. | -| [`requireFunction`](requireFunction.md) **New** | `Function` | Повертає значення як функцію або викидає виняток. | -| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Повертає значення як викликане значення або викидає виняток. | -| [`requireInteger`](requireInteger.md) **New** | `Number` | Повертає значення як ціле число або викидає виняток. | -| [`requireLength`](requireLength.md) **New** | `Number` | Повертає значення як припустиму довжину масиву або викидає виняток. | -| [`requireNaN`](requireNaN.md) **New** | `Number` | Повертає значення як `NaN` або викидає виняток. | -| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Повертає значення як `null` або `undefined` або викидає виняток. | -| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є масивом. | -| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є логічним значенням. | -| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом з дробовою частиною. | -| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є порожнім значенням. | -| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом з дробовою частиною. | -| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є цілим числом. | -| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом `NaN`. | -| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є безпечним цілим числом. | -| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Повертає значення як безпечне ціле число або викидає виняток. | -| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Повертає значення як символ або викидає виняток. | -| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Повертає значення як непорожній рядок або кидає виняток. | -| [`requireNonException`](requireNonException.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є екземпляром `Exception`. | -| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є функцією. | -| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є викликаним значенням. | -| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Повертає колекцію без змін, переконавшись, що жоден її елемент не дорівнює `null` чи `undefined`. | -| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є припустимою довжиною масиву. | -| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є значенням `null` або `undefined`. | -| [`requireNonNull`](requireNonNull.md) | `any` | Повертає значення, переконавшись, що воно не є значенням `null` або `undefined`. | -| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом. | -| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є перетворюваним на число. | -| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є об'єктом. | -| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є об'єктоподібним значенням. | -| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є регулярним виразом. | -| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є скалярним значенням. | -| [`requireNonString`](requireNonString.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є рядком. | -| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є символом. | -| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є значенням `undefined`. | -| [`requireNull`](requireNull.md) **New** | `Null` | Повертає значення як `null` або викидає виняток. | -| [`requireNumber`](requireNumber.md) **New** | `Number` | Повертає значення як число або викидає виняток. | -| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Повертає значення як числове значення або викидає виняток. | -| [`requireObject`](requireObject.md) **New** | `Object` | Повертає значення як об'єкт або викидає виняток. | -| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Повертає значення як об'єктоподібне значення або викидає виняток. | -| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Повертає значення як регулярний вираз або викидає виняток. | -| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Повертає значення як скалярне значення або викидає виняток. | -| [`requireState`](requireState.md) **New** | `void` | Стверджує, що умова виконується, і кидає виняток, якщо ні. | -| [`requireString`](requireString.md) | `String` | Повертає значення як рядок або викидає виняток. | -| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Повертає значення як `undefined` або викидає виняток. | -| [`requireUrl`](requireUrl.md) **New** | `String` | Повертає значення як URL-адресу або викидає виняток. | -| [`requireValidEmail`](requireValidEmail.md) | `String` | Повертає значення як адресу електронної пошти або викидає виняток. | -| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Повертає значення як код локалі або викидає виняток. | -| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Повертає значення як слаг або викидає виняток. | -| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Повертає значення як рядок версії або викидає виняток. | -| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Повертає версію, переконавшись, що вона задовольняє вимогу, інакше кидає виняток. | -| [`retry`](retry.md) **New** | `T` | Повторює виклик функції при винятку, збільшуючи паузу між спробами. | -| [`setPath`](setPath.md) **New** | `Object` | Записує вкладену властивість за шляхом, створюючи те, чого бракує. | -| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Вимірює час послідовності іменованих завдань. | -| [`stringifyJson`](stringifyJson.md) | `String` | Серіалізує значення в JSON із фіксованим порядком ключів. | -| [`toCamelCase`](toCamelCase.md) | `String` | Склеює слова рядка в camelCase. | -| [`toInteger`](toInteger.md) | `Number \| null` | Видобуває число зі значення або повідомляє, що числа немає. | -| [`toKebabCase`](toKebabCase.md) | `String` | Переписує рядок у kebab-case. | -| [`toLowerCase`](toLowerCase.md) | `String` | Зводить рядок до нижнього регістру, за бажанням прибираючи пробіли. | -| [`toProperCase`](toProperCase.md) | `String` | Робить першу літеру кожного слова великою, а решту малими. | -| [`toSnakeCase`](toSnakeCase.md) | `String` | Переписує рядок у snake_case. | -| [`toUpperCase`](toUpperCase.md) | `String` | Зводить рядок до верхнього регістру, за бажанням прибираючи пробіли. | -| [`transpose`](transpose.md) | `Array` | Міняє місцями рядки та стовпці матриці. | -| [`unique`](unique.md) **New** | `Array` | Видаляє з масиву повтори, зберігаючи перше входження кожного значення. | -| [`versionCompare`](versionCompare.md) | `Number` | Порівнює два рядки версій за числами. | -| [`without`](without.md) **New** | `Array` | Видаляє з масиву всі входження перелічених значень. | +| Функція | Повертає | Короткий опис | +| :--- | :--- | :--- | :--- | +| [`chunk`](chunk.md) | `Array` | Ділить масив на послідовні групи фіксованого розміру, перевіряючи обидва аргументи. | +| [`compact`](compact.md) **New** | `Array` | Видаляє з масиву всі хибні значення та звужує тип елементів без приведення. | +| [`decodeHtml`](decodeHtml.md) | `String` | Перетворює числові посилання на символи назад у символи. | +| [`diff`](diff.md) **New** | `Number` | Повертає інтервал між двома датами у вибраних одиницях. | +| [`encodeHtml`](encodeHtml.md) | `String` | Кодує кожен символ числовим посиланням. | +| [`equals`](equals.md) **New** | `Boolean` | Порівнює два значення вглиб і безпечно щодо null. | +| [`escapeHtml`](escapeHtml.md) | `String` | Замінює п'ять символів, які інакше були б прочитані як розмітка. | +| [`escapeRegExp`](escapeRegExp.md) | `String` | Екранує символи, що мають особливе значення в регулярному виразі. | +| [`escapeXml`](escapeXml.md) | `String` | Екранує символи, зарезервовані в XML. | +| [`first`](first.md) **New** | `Any` | Бере перший елемент масиву або його перші n елементів, без окремої перевірки на порожність. | +| [`flat`](flat.md) **New** | `Object` | Розгортає вкладений об'єкт в один рівень з ключами через крапку. | +| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Повертає кількість днів у місяці вказаної дати. | +| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Повертає, скільки днів лишається від дати до кінця її місяця. | +| [`getPath`](getPath.md) **New** | `Any` | Читає вкладену властивість за шляхом, із запасним значенням. | +| [`hashCode`](hashCode.md) | `Number` | Обчислює числовий хеш для будь-якого значення. | +| [`intersect`](intersect.md) **New** | `Array` | Знаходить значення, наявні в усіх переданих масивах. | +| [`is2DArray`](is2DArray.md) | `Boolean` | Перевіряє, що значення — непорожній масив, кожен елемент якого сам є масивом. | +| [`isArray`](isArray.md) | `Boolean` | Перевіряє, чи є значення масивом. | +| [`isBoolean`](isBoolean.md) | `Boolean` | Перевіряє, чи є значення логічним значенням. | +| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Перевіряє, що значення — непорожня матриця, усі рядки якої однакової довжини. | +| [`isCountable`](isCountable.md) | `Boolean` | Перевіряє, чи є значення лічильним числом. | +| [`isDouble`](isDouble.md) **New** | `Boolean` | Перевіряє, чи є значення числом з дробовою частиною. | +| [`isEmail`](isEmail.md) | `Boolean` | Перевіряє, чи є значення адресою електронної пошти. | +| [`isEmpty`](isEmpty.md) | `Boolean` | Перевіряє, чи є значення порожнім значенням. | +| [`isException`](isException.md) | `Boolean` | Перевіряє, чи є значення екземпляром `Exception`. | +| [`isFloat`](isFloat.md) **New** | `Boolean` | Перевіряє, чи є значення числом з дробовою частиною. | +| [`isFunction`](isFunction.md) | `Boolean` | Перевіряє, чи є значення функцією. | +| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Перевіряє, чи є значення викликаним значенням. | +| [`isInteger`](isInteger.md) | `Boolean` | Перевіряє, чи є значення цілим числом. | +| [`isLength`](isLength.md) | `Boolean` | Перевіряє, чи є значення припустимою довжиною масиву. | +| [`isNaN`](isNaN.md) **New** | `Boolean` | Перевіряє, чи є значення числом `NaN`. | +| [`isNil`](isNil.md) | `Boolean` | Перевіряє, чи є значення значенням `null` або `undefined`. | +| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Перевіряє, чи є значення невід'ємним числом. | +| [`isNull`](isNull.md) | `Boolean` | Перевіряє, чи є значення значенням `null`. | +| [`isNumber`](isNumber.md) | `Boolean` | Перевіряє, чи є значення числом. | +| [`isNumberLike`](isNumberLike.md) | `Boolean` | Перевіряє, чи є значення перетворюваним на число. | +| [`isObject`](isObject.md) | `Boolean` | Перевіряє, чи є значення об'єктом. | +| [`isObjectLike`](isObjectLike.md) | `Boolean` | Перевіряє, чи є значення об'єктоподібним значенням. | +| [`isRegExp`](isRegExp.md) | `Boolean` | Перевіряє, чи є значення регулярним виразом. | +| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Перевіряє, чи є значення безпечним цілим числом. | +| [`isScalar`](isScalar.md) | `Boolean` | Перевіряє, чи є значення скалярним значенням. | +| [`isString`](isString.md) | `Boolean` | Перевіряє, чи є значення рядком. | +| [`isSymbol`](isSymbol.md) | `Boolean` | Перевіряє, чи є значення символом. | +| [`last`](last.md) **New** | `Any` | Бере останній елемент масиву або його останні n елементів у початковому порядку. | +| [`merge`](merge.md) **New** | `String` | Підставляє значення об'єкта в плейсхолдери `{{ key }}` шаблону. | +| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Перевіряє, що значення **не** є числом з дробовою частиною. | +| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Повертає значення як непорожній рядок, називаючи аргумент у повідомленні про помилку. | +| [`isUndefined`](isUndefined.md) | `Boolean` | Перевіряє, чи є значення значенням `undefined`. | +| [`isUrl`](isUrl.md) | `Boolean` | Перевіряє, чи є значення URL-адресою. | +| [`isValidLocale`](isValidLocale.md) | `Boolean` | Перевіряє, чи є значення кодом локалі. | +| [`isValidSlug`](isValidSlug.md) | `Boolean` | Перевіряє, чи є значення слагом. | +| [`isValidVersion`](isValidVersion.md) | `Boolean` | Перевіряє, чи є значення рядком версії. | +| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Перевіряє, що версія не нижча за потрібну. | +| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Перевіряє, що значення **не** є непорожнім двовимірним масивом. | +| [`nonArray`](nonArray.md) | `Boolean` | Перевіряє, що значення **не** є масивом. | +| [`nonBoolean`](nonBoolean.md) | `Boolean` | Перевіряє, що значення **не** є логічним значенням. | +| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Перевіряє, що значення **не** є двовимірним масивом з однаковою довжиною рядків. | +| [`nonEmpty`](nonEmpty.md) | `Boolean` | Перевіряє, що значення **не** є порожнім значенням. | +| [`nonException`](nonException.md) **New** | `Boolean` | Перевіряє, що значення **не** є екземпляром `Exception`. | +| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Перевіряє, що значення **не** є числом з дробовою частиною. | +| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Перевіряє, що значення **не** є функцією. | +| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Перевіряє, що значення **не** є лічильним числом. | +| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Перевіряє, що значення **не** є викликаним значенням. | +| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Перевіряє, що значення **не** є цілим числом. | +| [`nonLength`](nonLength.md) **New** | `Boolean` | Перевіряє, що значення **не** є припустимою довжиною масиву. | +| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Перевіряє, що значення **не** є числом `NaN`. | +| [`nonNil`](nonNil.md) | `Boolean` | Перевіряє, що значення **не** є значенням `null` або `undefined`. | +| [`nonNull`](nonNull.md) | `Boolean` | Перевіряє, що значення **не** є значенням `null`. | +| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Перевіряє, що значення — невід'ємне число. | +| [`nonNumber`](nonNumber.md) | `Boolean` | Перевіряє, що значення **не** є числом. | +| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Перевіряє, що значення **не** є перетворюваним на число. | +| [`nonObject`](nonObject.md) **New** | `Boolean` | Перевіряє, що значення **не** є об'єктом. | +| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Перевіряє, що значення **не** є об'єктоподібним значенням. | +| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Перевіряє, що значення **не** є регулярним виразом. | +| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Перевіряє, що значення **не** є безпечним цілим числом. | +| [`nonScalar`](nonScalar.md) | `Boolean` | Перевіряє, що значення **не** є скалярним значенням. | +| [`nonString`](nonString.md) | `Boolean` | Перевіряє, що значення **не** є рядком. | +| [`nonSymbol`](nonSymbol.md) | `Boolean` | Перевіряє, що значення **не** є символом. | +| [`nonUndefined`](nonUndefined.md) | `Boolean` | Перевіряє, що значення **не** є значенням `undefined`. | +| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Перевіряє, що значення **не** є URL-адресою. | +| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Перевіряє, що значення **не** є адресою електронної пошти. | +| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Перевіряє, що значення **не** є кодом локалі. | +| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Перевіряє, що значення **не** є слагом. | +| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Перевіряє, що значення **не** є рядком версії. | +| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Перевіряє, що версія нижча за потрібну. | +| [`now`](now.md) | `Number` | Повертає поточний час у мілісекундах від початку епохи. | +| [`ObjectTag`](ObjectTag.md) | `Enum` | Внутрішні теги, які може повідомити значення, у вигляді іменованих констант. | +| [`objectToString`](objectToString.md) | `String` | Повертає внутрішній тег значення. | +| [`offset`](offset.md) **New** | `Date` | Зсуває дату на задану кількість одиниць. | +| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Розбирає JSON, а при невдачі суворого розбору пробує нестрогий. | +| [`require2DArray`](require2DArray.md) **New** | `Array` | Повертає значення як непорожній двовимірний масив або викидає виняток. | +| [`requireArray`](requireArray.md) **New** | `Array` | Повертає значення як масив або викидає виняток. | +| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Повертає значення як логічне значення або викидає виняток. | +| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Повертає значення як двовимірний масив з однаковою довжиною рядків або викидає виняток. | +| [`requireCountable`](requireCountable.md) **New** | `Number` | Повертає значення як лічильне число або викидає виняток. | +| [`requireDouble`](requireDouble.md) **New** | `Number` | Повертає значення як число з дробовою частиною або викидає виняток. | +| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Повертає значення як порожнє значення або викидає виняток. | +| [`requireException`](requireException.md) **New** | `Exception` | Повертає значення як `Exception` або викидає виняток. | +| [`requireFloat`](requireFloat.md) **New** | `Number` | Повертає значення як число з дробовою частиною або викидає виняток. | +| [`requireFunction`](requireFunction.md) **New** | `Function` | Повертає значення як функцію або викидає виняток. | +| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Повертає значення як викликане значення або викидає виняток. | +| [`requireInteger`](requireInteger.md) **New** | `Number` | Повертає значення як ціле число або викидає виняток. | +| [`requireLength`](requireLength.md) **New** | `Number` | Повертає значення як припустиму довжину масиву або викидає виняток. | +| [`requireNaN`](requireNaN.md) **New** | `Number` | Повертає значення як `NaN` або викидає виняток. | +| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Повертає значення як `null` або `undefined` або викидає виняток. | +| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є масивом. | +| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є логічним значенням. | +| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом з дробовою частиною. | +| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є порожнім значенням. | +| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом з дробовою частиною. | +| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є цілим числом. | +| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом `NaN`. | +| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є безпечним цілим числом. | +| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Повертає значення як безпечне ціле число або викидає виняток. | +| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Повертає значення як символ або викидає виняток. | +| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Повертає значення як непорожній рядок або кидає виняток. | +| [`requireNonException`](requireNonException.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є екземпляром `Exception`. | +| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є функцією. | +| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є викликаним значенням. | +| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Повертає колекцію без змін, переконавшись, що жоден її елемент не дорівнює `null` чи `undefined`. | +| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є припустимою довжиною масиву. | +| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є значенням `null` або `undefined`. | +| [`requireNonNull`](requireNonNull.md) | `any` | Повертає значення, переконавшись, що воно не є значенням `null` або `undefined`. | +| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є числом. | +| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є перетворюваним на число. | +| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є об'єктом. | +| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є об'єктоподібним значенням. | +| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є регулярним виразом. | +| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є скалярним значенням. | +| [`requireNonString`](requireNonString.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є рядком. | +| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є символом. | +| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Повертає значення, переконавшись, що воно не є значенням `undefined`. | +| [`requireNull`](requireNull.md) **New** | `Null` | Повертає значення як `null` або викидає виняток. | +| [`requireNumber`](requireNumber.md) **New** | `Number` | Повертає значення як число або викидає виняток. | +| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Повертає значення як числове значення або викидає виняток. | +| [`requireObject`](requireObject.md) **New** | `Object` | Повертає значення як об'єкт або викидає виняток. | +| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Повертає значення як об'єктоподібне значення або викидає виняток. | +| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Повертає значення як регулярний вираз або викидає виняток. | +| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Повертає значення як скалярне значення або викидає виняток. | +| [`requireState`](requireState.md) **New** | `void` | Стверджує, що умова виконується, і кидає виняток, якщо ні. | +| [`requireString`](requireString.md) | `String` | Повертає значення як рядок або викидає виняток. | +| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Повертає значення як `undefined` або викидає виняток. | +| [`requireUrl`](requireUrl.md) **New** | `String` | Повертає значення як URL-адресу або викидає виняток. | +| [`requireValidEmail`](requireValidEmail.md) | `String` | Повертає значення як адресу електронної пошти або викидає виняток. | +| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Повертає значення як код локалі або викидає виняток. | +| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Повертає значення як слаг або викидає виняток. | +| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Повертає значення як рядок версії або викидає виняток. | +| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Повертає версію, переконавшись, що вона задовольняє вимогу, інакше кидає виняток. | +| [`retry`](retry.md) **New** | `T` | Повторює виклик функції при винятку, збільшуючи паузу між спробами. | +| [`setPath`](setPath.md) **New** | `Object` | Записує вкладену властивість за шляхом, створюючи те, чого бракує. | +| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Вимірює час послідовності іменованих завдань. | +| [`stringifyJson`](stringifyJson.md) | `String` | Серіалізує значення в JSON із фіксованим порядком ключів. | +| [`toCamelCase`](toCamelCase.md) | `String` | Склеює слова рядка в camelCase. | +| [`toInteger`](toInteger.md) | `Number \| null` | Видобуває число зі значення або повідомляє, що числа немає. | +| [`toKebabCase`](toKebabCase.md) | `String` | Переписує рядок у kebab-case. | +| [`toLowerCase`](toLowerCase.md) | `String` | Зводить рядок до нижнього регістру, за бажанням прибираючи пробіли. | +| [`toProperCase`](toProperCase.md) | `String` | Робить першу літеру кожного слова великою, а решту малими. | +| [`toSnakeCase`](toSnakeCase.md) | `String` | Переписує рядок у snake_case. | +| [`toUpperCase`](toUpperCase.md) | `String` | Зводить рядок до верхнього регістру, за бажанням прибираючи пробіли. | +| [`transpose`](transpose.md) | `Array` | Міняє місцями рядки та стовпці матриці. | +| [`unique`](unique.md) **New** | `Array` | Видаляє з масиву повтори, зберігаючи перше входження кожного значення. | +| [`versionCompare`](versionCompare.md) | `Number` | Порівнює два рядки версій за числами. | +| [`without`](without.md) **New** | `Array` | Видаляє з масиву всі входження перелічених значень. | diff --git a/docs/writerside/topics/reference-base.md b/docs/writerside/topics/reference-base.md index 737526ac..e1da7434 100644 --- a/docs/writerside/topics/reference-base.md +++ b/docs/writerside/topics/reference-base.md @@ -10,168 +10,168 @@ manipulation, and JSON/HTML handling. These do not depend on the Google Apps Scr A **New** marker indicates a function added in the latest release; a **Deprecated** marker indicates a function scheduled for removal in a future release. -| Function | Return type | Brief description | +| Function | Return type | Brief description | | :---------------------------------------------------------------- | :--------------- | :------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -| [`chunk`](chunk.md) | `Array` | Divides an array into multiple smaller arrays of a specified size. | -| [`compact`](compact.md) **New** | `Array` | Drops every falsy value from an array, narrowing the element type without a cast. | -| [`decodeHtml`](decodeHtml.md) | `String` | Decodes HTML entities (e.g., `&` -> `&`) back to plain text. | -| [`diff`](diff.md) **New** | `Number` | Returns the interval between two dates in a chosen unit, counting calendar units by the calendar. | -| [`encodeHtml`](encodeHtml.md) | `String` | Encodes a string for safe rendering in HTML. | -| [`equals`](equals.md) **New** | `Boolean` | Compares two values deeply and null-safely; the counterpart of `hashCode`. | -| [`escapeHtml`](escapeHtml.md) | `String` | Escapes special characters (`<`, `>`, `&`, etc.) for HTML. | -| [`escapeRegExp`](escapeRegExp.md) | `String` | Escapes special characters for safe use within regular expressions. | -| [`escapeXml`](escapeXml.md) | `String` | Escapes special characters for safe use in XML documents. | -| [`first`](first.md) **New** | `Any` | Takes the first element of an array, or its first `n` elements. | -| [`flat`](flat.md) **New** | `Object` | Flattens a nested object into a single level of dotted keys, keeping arrays whole. | -| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Returns the number of calendar days in the month a given date falls in. | -| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Returns the number of calendar days between a date and the end of its month. | -| [`getPath`](getPath.md) **New** | `Any` | Reads a nested property by path, returning a fallback when the path does not resolve. | -| [`hashCode`](hashCode.md) | `Number` | Generates a numeric hash code for a given string. | -| [`intersect`](intersect.md) **New** | `Array` | Finds the values present in every given array, in the order of the first. | -| [`is2DArray`](is2DArray.md) | `Boolean` | Validates if a value is a two-dimensional array. | -| [`isArray`](isArray.md) | `Boolean` | Validates if a value is an `Array`. | -| [`isBoolean`](isBoolean.md) | `Boolean` | Validates if a value is a boolean. | -| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Validates if a 2D array has uniform inner array lengths. | -| [`isCountable`](isCountable.md) | `Boolean` | Checks if a value is a non-negative safe integer. | -| [`isDouble`](isDouble.md) **New** | `Boolean` | Checks if a value is a finite number carrying a fractional part; a synonym of `isFloat`. | -| [`isEmail`](isEmail.md) | `Boolean` | Validates if a string follows a proper email format. | -| [`isEmpty`](isEmpty.md) | `Boolean` | Checks if a value is considered empty (null, undefined, empty string/array/object). | -| [`isException`](isException.md) | `Boolean` | Validates if a value is an instance of `Exception` or a derived class. | -| [`isFloat`](isFloat.md) **New** | `Boolean` | Checks if a value is a finite number carrying a fractional part. | -| [`isFunction`](isFunction.md) | `Boolean` | Validates if a value is a function. | -| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Validates if a value is "function-like" (e.g., callable). | -| [`isInteger`](isInteger.md) | `Boolean` | Checks if a value is a number and an integer. | -| [`isLength`](isLength.md) | `Boolean` | Validates if a value is a valid array-like length. | -| [`isNaN`](isNaN.md) **New** | `Boolean` | Checks if a value is the `NaN` number, without the coercion the global `isNaN` performs. | -| [`isNil`](isNil.md) | `Boolean` | Checks if a value is `null` or `undefined`. | -| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Checks if a value is a number greater than or equal to zero. | -| [`isNull`](isNull.md) | `Boolean` | Checks if a value is `null`. | -| [`isNumber`](isNumber.md) | `Boolean` | Validates if a value is a number. | -| [`isNumberLike`](isNumberLike.md) | `Boolean` | Checks if a value can be reliably converted to a number. | -| [`isObject`](isObject.md) | `Boolean` | Validates if a value is a plain object (excluding null and arrays). | -| [`isObjectLike`](isObjectLike.md) | `Boolean` | Checks if a value is an object (including arrays and functions). | -| [`isRegExp`](isRegExp.md) | `Boolean` | Validates if a value is a regular expression. | -| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Checks if a value is a number and a safe integer (exactly representable as an IEEE-754 double). | -| [`isScalar`](isScalar.md) | `Boolean` | Checks if a value is a primitive scalar type (string, number, boolean, symbol, bigint). | -| [`isString`](isString.md) | `Boolean` | Validates if a value is a string. | -| [`isSymbol`](isSymbol.md) | `Boolean` | Validates if a value is a symbol. | -| [`last`](last.md) **New** | `Any` | Takes the last element of an array, or its last `n` elements in their original order. | -| [`merge`](merge.md) **New** | `String` | Substitutes object values into `{{ key }}` placeholders in a template string. | -| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Validates if a value is **not** a finite number carrying a fractional part; a synonym of `nonFloat`. | -| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Validates that the given value is a non-empty string. Use `requireNonEmptyString` instead. | -| [`isUndefined`](isUndefined.md) | `Boolean` | Checks if a value is `undefined`. | -| [`isUrl`](isUrl.md) | `Boolean` | Validates if a string is a properly formatted URL. | -| [`isValidLocale`](isValidLocale.md) | `Boolean` | Validates if a string is a valid BCP 47 locale code. | -| [`isValidSlug`](isValidSlug.md) | `Boolean` | Validates if a string is a URL-friendly slug. | -| [`isValidVersion`](isValidVersion.md) | `Boolean` | Validates if a string follows Semantic Versioning rules. | -| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Determines if two version strings are compatible based on SemVer. | -| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Validates if a value is **not** a two-dimensional array. | -| [`nonArray`](nonArray.md) | `Boolean` | Checks if a value is NOT an `Array`. | -| [`nonBoolean`](nonBoolean.md) | `Boolean` | Checks if a value is NOT a boolean. | -| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Validates if a 2D array does **not** have uniform inner array lengths. | -| [`nonEmpty`](nonEmpty.md) | `Boolean` | Checks if a value is NOT empty. | -| [`nonException`](nonException.md) **New** | `Boolean` | Validates if a value is **not** an instance of `Exception` or a derived class. | -| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Validates if a value is **not** a finite number carrying a fractional part. | -| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Checks if a value is NOT a `Function`. | -| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Validates if a value is **not** a countable number (a non-negative safe integer). | -| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Validates if a value is **not** "function-like" (e.g., callable). | -| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Validates if a value is **not** a number and an integer. | -| [`nonLength`](nonLength.md) **New** | `Boolean` | Validates if a value is **not** a valid array-like length. | -| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Validates if a value is **not** the `NaN` number, without coercing it first. | -| [`nonNil`](nonNil.md) | `Boolean` | Checks if a value is NOT `null` or `undefined`. | -| [`nonNull`](nonNull.md) | `Boolean` | Checks if a value is NOT `null`. | -| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Checks if a value is a non-negative number. Use `isNonNegative` instead. | -| [`nonNumber`](nonNumber.md) | `Boolean` | Checks if a value is NOT a number. | -| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Validates if a value is **not** a number in a broader sense (e.g., a numeric string). | -| [`nonObject`](nonObject.md) **New** | `Boolean` | Validates if a value is **not** an `Object`. | -| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Validates if a value is **not** an object in a broader sense (functions included). | -| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Validates if a value is **not** a regular expression. | -| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Validates if a value is **not** a safe integer. | -| [`nonScalar`](nonScalar.md) | `Boolean` | Checks if a value is NOT a scalar type. | -| [`nonString`](nonString.md) | `Boolean` | Checks if a value is NOT a string. | -| [`nonSymbol`](nonSymbol.md) | `Boolean` | Checks if a value is NOT a `Symbol`. | -| [`nonUndefined`](nonUndefined.md) | `Boolean` | Checks if a value is NOT `undefined`. | -| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Validates if a value is **not** a properly formatted URL. | -| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Validates if a string is **not** a properly formatted email address. | -| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Validates if a string is **not** a valid locale code. | -| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Validates if a string is **not** a valid slug. | -| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Validates if a string is **not** a valid version. | -| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Validates if one version is **not** compatible with (i.e. lower than) another. | -| [`now`](now.md) | `Number` | Returns the current timestamp in milliseconds. | -| [`ObjectTag`](ObjectTag.md) | `Enum` | Enum representing `Object#toString` result references in uppercase. | -| [`objectToString`](objectToString.md) | `String` | Converts a value to its `Object#toString` tag, e.g. `[object Array]`. | -| [`offset`](offset.md) **New** | `Date` | Shifts a date by an interval and returns a new `Date`, never mutating the input. | -| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Safely parses a JSON string, handling potential errors. | -| [`require2DArray`](require2DArray.md) **New** | `Array` | Ensures a value is a non-empty two-dimensional array, throwing otherwise. | -| [`requireArray`](requireArray.md) **New** | `Array` | Ensures a value is an `Array`, throwing `IllegalArgumentException` otherwise. | -| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Ensures a value is a boolean, throwing `IllegalArgumentException` otherwise. | -| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Ensures a 2D array has uniform inner array lengths, throwing otherwise. | -| [`requireCountable`](requireCountable.md) **New** | `Number` | Ensures a value is a countable number (a non-negative safe integer), throwing otherwise. | -| [`requireDouble`](requireDouble.md) **New** | `Number` | Ensures a value is a finite number carrying a fractional part, throwing otherwise; a synonym of `requireFloat`. | -| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Ensures a value is empty, throwing `IllegalArgumentException` otherwise. | -| [`requireException`](requireException.md) **New** | `Exception` | Ensures a value is an `Exception` or a derived class, throwing otherwise. | -| [`requireFloat`](requireFloat.md) **New** | `Number` | Ensures a value is a finite number carrying a fractional part, throwing otherwise. | -| [`requireFunction`](requireFunction.md) **New** | `Function` | Ensures a value is a function, throwing `IllegalArgumentException` otherwise. | -| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Ensures a value is callable in a broader sense, throwing `IllegalArgumentException` otherwise. | -| [`requireInteger`](requireInteger.md) **New** | `Number` | Ensures a value is an integer, throwing `IllegalArgumentException` otherwise. | -| [`requireLength`](requireLength.md) **New** | `Number` | Ensures a value is a valid array-like length, throwing `IllegalArgumentException` otherwise. | -| [`requireNaN`](requireNaN.md) **New** | `Number` | Ensures a value is the `NaN` number, without coercing it first, throwing otherwise. | -| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Ensures a value is `null` or `undefined`, throwing otherwise. | -| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Ensures a value is **not** an `Array`, throwing `IllegalArgumentException` otherwise. | -| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Ensures a value is **not** a boolean, throwing `IllegalArgumentException` otherwise. | -| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Ensures a value is **not** a finite number carrying a fractional part, throwing otherwise; a synonym of `requireNonFloat`. | -| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Ensures a value is **not** empty, throwing `IllegalArgumentException` otherwise. | -| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Ensures a value is **not** a finite number carrying a fractional part, throwing otherwise. | -| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Ensures a value is **not** an integer, throwing otherwise. | -| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Ensures a value is **not** the `NaN` number, throwing otherwise. | -| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Ensures a value is **not** a safe integer, throwing otherwise. | -| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Ensures a value is a safe integer (exactly representable as an IEEE-754 double), throwing otherwise. | -| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Ensures a value is a `Symbol`, throwing `IllegalArgumentException` otherwise. | -| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Ensures a string is not empty, otherwise throws an exception. | -| [`requireNonException`](requireNonException.md) **New** | `Any` | Ensures a value is **not** an `Exception`, throwing `IllegalArgumentException` otherwise. | -| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Ensures a value is **not** a function, throwing `IllegalArgumentException` otherwise. | -| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Ensures a value is **not** callable, throwing `IllegalArgumentException` otherwise. | -| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Throws `IllegalArgumentException` if an array, `Set` or `Map` holds a `null` or `undefined` element. | -| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Ensures a value is **not** a valid array-like length, throwing `IllegalArgumentException` otherwise. | -| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Ensures a value is neither `null` nor `undefined`, throwing `IllegalArgumentException`. | -| [`requireNonNull`](requireNonNull.md) | `any` | Ensures a value is not `null`, otherwise throws an exception. | -| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Ensures a value is **not** a number, throwing `IllegalArgumentException` otherwise. | -| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Ensures a value is **not** numeric in a broader sense, throwing `IllegalArgumentException` otherwise. | -| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Ensures a value is **not** an `Object`, throwing `IllegalArgumentException` otherwise. | -| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Ensures a value is **not** object-like (functions included), throwing `IllegalArgumentException` otherwise. | -| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Ensures a value is **not** a regular expression, throwing `IllegalArgumentException` otherwise. | -| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Ensures a value is **not** a scalar primitive, throwing `IllegalArgumentException` otherwise. | -| [`requireNonString`](requireNonString.md) **New** | `Any` | Ensures a value is **not** a string, throwing `IllegalArgumentException` otherwise. | -| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Ensures a value is **not** a `Symbol`, throwing `IllegalArgumentException` otherwise. | -| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Ensures a value is **not** `undefined`, throwing `IllegalArgumentException` otherwise. | -| [`requireNull`](requireNull.md) **New** | `Null` | Ensures a value is `null`, throwing `IllegalArgumentException` otherwise. | -| [`requireNumber`](requireNumber.md) **New** | `Number` | Ensures a value is a number, throwing `IllegalArgumentException` otherwise. | -| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Ensures a value is numeric in a broader sense (a number or a numeric string), throwing otherwise. | -| [`requireObject`](requireObject.md) **New** | `Object` | Ensures a value is an `Object`, throwing `IllegalArgumentException` otherwise. | -| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Ensures a value is object-like (functions included), throwing `IllegalArgumentException` otherwise. | -| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Ensures a value is a regular expression, throwing `IllegalArgumentException` otherwise. | -| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Ensures a value is a scalar primitive, throwing `IllegalArgumentException` otherwise. | -| [`requireState`](requireState.md) **New** | `void` | Throws `IllegalStateException` when a condition does not hold. | -| [`requireString`](requireString.md) | `String` | Ensures a value is a string, otherwise throws an exception. | -| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Ensures a value is `undefined`, throwing `IllegalArgumentException` otherwise. | -| [`requireUrl`](requireUrl.md) **New** | `String` | Ensures a value is a properly formatted URL, throwing otherwise. | -| [`requireValidEmail`](requireValidEmail.md) | `String` | Ensures a string is a valid email, otherwise throws an exception. | -| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Ensures a string is a valid locale code, throwing otherwise. | -| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Ensures a string is a valid slug, throwing otherwise. | -| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Ensures a string is a valid version, throwing otherwise. | -| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Ensures one version is at least another, throwing otherwise. | -| [`retry`](retry.md) **New** | `T` | Calls a function until it succeeds, waiting longer between each failure. | -| [`setPath`](setPath.md) **New** | `Object` | Writes a nested property by path, creating missing levels and refusing prototype keys. | -| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Times a sequence of named tasks and prints a breakdown. | -| [`stringifyJson`](stringifyJson.md) | `String` | Safely converts an object to a JSON string. | -| [`toCamelCase`](toCamelCase.md) | `String` | Converts a string to `camelCase`. | -| [`toInteger`](toInteger.md) | `Number \| null` | Converts a value to an integer, returning `null` on failure. | -| [`toKebabCase`](toKebabCase.md) | `String` | Converts a string to `kebab-case`. | -| [`toLowerCase`](toLowerCase.md) | `String` | Converts a string to lowercase. | -| [`toProperCase`](toProperCase.md) | `String` | Converts a string to Proper Case (capitalizing the first letter of each word). | -| [`toSnakeCase`](toSnakeCase.md) | `String` | Converts a string to `snake_case`. | -| [`toUpperCase`](toUpperCase.md) | `String` | Converts a string to uppercase. | -| [`transpose`](transpose.md) | `Array` | Flips a 2D array over its diagonal (swaps rows and columns). | -| [`unique`](unique.md) **New** | `Array` | Removes duplicates from an array, keeping the first occurrence of each value. | -| [`versionCompare`](versionCompare.md) | `Number` | Compares two version strings, returning -1, 0, or 1. | -| [`without`](without.md) **New** | `Array` | Excludes the given values from an array, comparing with `SameValueZero`. | +| [`chunk`](chunk.md) | `Array` | Divides an array into multiple smaller arrays of a specified size. | +| [`compact`](compact.md) **New** | `Array` | Drops every falsy value from an array, narrowing the element type without a cast. | +| [`decodeHtml`](decodeHtml.md) | `String` | Decodes HTML entities (e.g., `&` -> `&`) back to plain text. | +| [`diff`](diff.md) **New** | `Number` | Returns the interval between two dates in a chosen unit, counting calendar units by the calendar. | +| [`encodeHtml`](encodeHtml.md) | `String` | Encodes a string for safe rendering in HTML. | +| [`equals`](equals.md) **New** | `Boolean` | Compares two values deeply and null-safely; the counterpart of `hashCode`. | +| [`escapeHtml`](escapeHtml.md) | `String` | Escapes special characters (`<`, `>`, `&`, etc.) for HTML. | +| [`escapeRegExp`](escapeRegExp.md) | `String` | Escapes special characters for safe use within regular expressions. | +| [`escapeXml`](escapeXml.md) | `String` | Escapes special characters for safe use in XML documents. | +| [`first`](first.md) **New** | `Any` | Takes the first element of an array, or its first `n` elements. | +| [`flat`](flat.md) **New** | `Object` | Flattens a nested object into a single level of dotted keys, keeping arrays whole. | +| [`getDaysInMonth`](getDaysInMonth.md) **New** | `Number` | Returns the number of calendar days in the month a given date falls in. | +| [`getDaysLeftInMonth`](getDaysLeftInMonth.md) **New** | `Number` | Returns the number of calendar days between a date and the end of its month. | +| [`getPath`](getPath.md) **New** | `Any` | Reads a nested property by path, returning a fallback when the path does not resolve. | +| [`hashCode`](hashCode.md) | `Number` | Generates a numeric hash code for a given string. | +| [`intersect`](intersect.md) **New** | `Array` | Finds the values present in every given array, in the order of the first. | +| [`is2DArray`](is2DArray.md) | `Boolean` | Validates if a value is a two-dimensional array. | +| [`isArray`](isArray.md) | `Boolean` | Validates if a value is an `Array`. | +| [`isBoolean`](isBoolean.md) | `Boolean` | Validates if a value is a boolean. | +| [`isConsistent2DArray`](isConsistent2DArray.md) | `Boolean` | Validates if a 2D array has uniform inner array lengths. | +| [`isCountable`](isCountable.md) | `Boolean` | Checks if a value is a non-negative safe integer. | +| [`isDouble`](isDouble.md) **New** | `Boolean` | Checks if a value is a finite number carrying a fractional part; a synonym of `isFloat`. | +| [`isEmail`](isEmail.md) | `Boolean` | Validates if a string follows a proper email format. | +| [`isEmpty`](isEmpty.md) | `Boolean` | Checks if a value is considered empty (null, undefined, empty string/array/object). | +| [`isException`](isException.md) | `Boolean` | Validates if a value is an instance of `Exception` or a derived class. | +| [`isFloat`](isFloat.md) **New** | `Boolean` | Checks if a value is a finite number carrying a fractional part. | +| [`isFunction`](isFunction.md) | `Boolean` | Validates if a value is a function. | +| [`isFunctionLike`](isFunctionLike.md) | `Boolean` | Validates if a value is "function-like" (e.g., callable). | +| [`isInteger`](isInteger.md) | `Boolean` | Checks if a value is a number and an integer. | +| [`isLength`](isLength.md) | `Boolean` | Validates if a value is a valid array-like length. | +| [`isNaN`](isNaN.md) **New** | `Boolean` | Checks if a value is the `NaN` number, without the coercion the global `isNaN` performs. | +| [`isNil`](isNil.md) | `Boolean` | Checks if a value is `null` or `undefined`. | +| [`isNonNegative`](isNonNegative.md) **New** | `Boolean` | Checks if a value is a number greater than or equal to zero. | +| [`isNull`](isNull.md) | `Boolean` | Checks if a value is `null`. | +| [`isNumber`](isNumber.md) | `Boolean` | Validates if a value is a number. | +| [`isNumberLike`](isNumberLike.md) | `Boolean` | Checks if a value can be reliably converted to a number. | +| [`isObject`](isObject.md) | `Boolean` | Validates if a value is a plain object (excluding null and arrays). | +| [`isObjectLike`](isObjectLike.md) | `Boolean` | Checks if a value is an object (including arrays and functions). | +| [`isRegExp`](isRegExp.md) | `Boolean` | Validates if a value is a regular expression. | +| [`isSafeInteger`](isSafeInteger.md) **New** | `Boolean` | Checks if a value is a number and a safe integer (exactly representable as an IEEE-754 double). | +| [`isScalar`](isScalar.md) | `Boolean` | Checks if a value is a primitive scalar type (string, number, boolean, symbol, bigint). | +| [`isString`](isString.md) | `Boolean` | Validates if a value is a string. | +| [`isSymbol`](isSymbol.md) | `Boolean` | Validates if a value is a symbol. | +| [`last`](last.md) **New** | `Any` | Takes the last element of an array, or its last `n` elements in their original order. | +| [`merge`](merge.md) **New** | `String` | Substitutes object values into `{{ key }}` placeholders in a template string. | +| [`nonDouble`](nonDouble.md) **New** | `Boolean` | Validates if a value is **not** a finite number carrying a fractional part; a synonym of `nonFloat`. | +| [`nonEmptyString`](nonEmptyString.md) **Deprecated** | `String` | Validates that the given value is a non-empty string. Use `requireNonEmptyString` instead. | +| [`isUndefined`](isUndefined.md) | `Boolean` | Checks if a value is `undefined`. | +| [`isUrl`](isUrl.md) | `Boolean` | Validates if a string is a properly formatted URL. | +| [`isValidLocale`](isValidLocale.md) | `Boolean` | Validates if a string is a valid BCP 47 locale code. | +| [`isValidSlug`](isValidSlug.md) | `Boolean` | Validates if a string is a URL-friendly slug. | +| [`isValidVersion`](isValidVersion.md) | `Boolean` | Validates if a string follows Semantic Versioning rules. | +| [`isVersionCompatible`](isVersionCompatible.md) | `Boolean` | Determines if two version strings are compatible based on SemVer. | +| [`non2DArray`](non2DArray.md) **New** | `Boolean` | Validates if a value is **not** a two-dimensional array. | +| [`nonArray`](nonArray.md) | `Boolean` | Checks if a value is NOT an `Array`. | +| [`nonBoolean`](nonBoolean.md) | `Boolean` | Checks if a value is NOT a boolean. | +| [`nonConsistent2DArray`](nonConsistent2DArray.md) **New** | `Boolean` | Validates if a 2D array does **not** have uniform inner array lengths. | +| [`nonEmpty`](nonEmpty.md) | `Boolean` | Checks if a value is NOT empty. | +| [`nonException`](nonException.md) **New** | `Boolean` | Validates if a value is **not** an instance of `Exception` or a derived class. | +| [`nonFloat`](nonFloat.md) **New** | `Boolean` | Validates if a value is **not** a finite number carrying a fractional part. | +| [`nonFunction`](nonFunction.md) **New** | `Boolean` | Checks if a value is NOT a `Function`. | +| [`nonCountable`](nonCountable.md) **New** | `Boolean` | Validates if a value is **not** a countable number (a non-negative safe integer). | +| [`nonFunctionLike`](nonFunctionLike.md) **New** | `Boolean` | Validates if a value is **not** "function-like" (e.g., callable). | +| [`nonInteger`](nonInteger.md) **New** | `Boolean` | Validates if a value is **not** a number and an integer. | +| [`nonLength`](nonLength.md) **New** | `Boolean` | Validates if a value is **not** a valid array-like length. | +| [`nonNaN`](nonNaN.md) **New** | `Boolean` | Validates if a value is **not** the `NaN` number, without coercing it first. | +| [`nonNil`](nonNil.md) | `Boolean` | Checks if a value is NOT `null` or `undefined`. | +| [`nonNull`](nonNull.md) | `Boolean` | Checks if a value is NOT `null`. | +| [`nonNegative`](nonNegative.md) **Deprecated** | `Boolean` | Checks if a value is a non-negative number. Use `isNonNegative` instead. | +| [`nonNumber`](nonNumber.md) | `Boolean` | Checks if a value is NOT a number. | +| [`nonNumberLike`](nonNumberLike.md) **New** | `Boolean` | Validates if a value is **not** a number in a broader sense (e.g., a numeric string). | +| [`nonObject`](nonObject.md) **New** | `Boolean` | Validates if a value is **not** an `Object`. | +| [`nonObjectLike`](nonObjectLike.md) **New** | `Boolean` | Validates if a value is **not** an object in a broader sense (functions included). | +| [`nonRegExp`](nonRegExp.md) **New** | `Boolean` | Validates if a value is **not** a regular expression. | +| [`nonSafeInteger`](nonSafeInteger.md) **New** | `Boolean` | Validates if a value is **not** a safe integer. | +| [`nonScalar`](nonScalar.md) | `Boolean` | Checks if a value is NOT a scalar type. | +| [`nonString`](nonString.md) | `Boolean` | Checks if a value is NOT a string. | +| [`nonSymbol`](nonSymbol.md) | `Boolean` | Checks if a value is NOT a `Symbol`. | +| [`nonUndefined`](nonUndefined.md) | `Boolean` | Checks if a value is NOT `undefined`. | +| [`nonUrl`](nonUrl.md) **New** | `Boolean` | Validates if a value is **not** a properly formatted URL. | +| [`nonValidEmail`](nonValidEmail.md) **New** | `Boolean` | Validates if a string is **not** a properly formatted email address. | +| [`nonValidLocale`](nonValidLocale.md) **New** | `Boolean` | Validates if a string is **not** a valid locale code. | +| [`nonValidSlug`](nonValidSlug.md) **New** | `Boolean` | Validates if a string is **not** a valid slug. | +| [`nonValidVersion`](nonValidVersion.md) **New** | `Boolean` | Validates if a string is **not** a valid version. | +| [`nonVersionCompatible`](nonVersionCompatible.md) **New** | `Boolean` | Validates if one version is **not** compatible with (i.e. lower than) another. | +| [`now`](now.md) | `Number` | Returns the current timestamp in milliseconds. | +| [`ObjectTag`](ObjectTag.md) | `Enum` | Enum representing `Object#toString` result references in uppercase. | +| [`objectToString`](objectToString.md) | `String` | Converts a value to its `Object#toString` tag, e.g. `[object Array]`. | +| [`offset`](offset.md) **New** | `Date` | Shifts a date by an interval and returns a new `Date`, never mutating the input. | +| [`parseJson`](parseJson.md) **Deprecated** | `Object` | Safely parses a JSON string, handling potential errors. | +| [`require2DArray`](require2DArray.md) **New** | `Array` | Ensures a value is a non-empty two-dimensional array, throwing otherwise. | +| [`requireArray`](requireArray.md) **New** | `Array` | Ensures a value is an `Array`, throwing `IllegalArgumentException` otherwise. | +| [`requireBoolean`](requireBoolean.md) **New** | `Boolean` | Ensures a value is a boolean, throwing `IllegalArgumentException` otherwise. | +| [`requireConsistent2DArray`](requireConsistent2DArray.md) **New** | `Array` | Ensures a 2D array has uniform inner array lengths, throwing otherwise. | +| [`requireCountable`](requireCountable.md) **New** | `Number` | Ensures a value is a countable number (a non-negative safe integer), throwing otherwise. | +| [`requireDouble`](requireDouble.md) **New** | `Number` | Ensures a value is a finite number carrying a fractional part, throwing otherwise; a synonym of `requireFloat`. | +| [`requireEmpty`](requireEmpty.md) **New** | `Any` | Ensures a value is empty, throwing `IllegalArgumentException` otherwise. | +| [`requireException`](requireException.md) **New** | `Exception` | Ensures a value is an `Exception` or a derived class, throwing otherwise. | +| [`requireFloat`](requireFloat.md) **New** | `Number` | Ensures a value is a finite number carrying a fractional part, throwing otherwise. | +| [`requireFunction`](requireFunction.md) **New** | `Function` | Ensures a value is a function, throwing `IllegalArgumentException` otherwise. | +| [`requireFunctionLike`](requireFunctionLike.md) **New** | `Function` | Ensures a value is callable in a broader sense, throwing `IllegalArgumentException` otherwise. | +| [`requireInteger`](requireInteger.md) **New** | `Number` | Ensures a value is an integer, throwing `IllegalArgumentException` otherwise. | +| [`requireLength`](requireLength.md) **New** | `Number` | Ensures a value is a valid array-like length, throwing `IllegalArgumentException` otherwise. | +| [`requireNaN`](requireNaN.md) **New** | `Number` | Ensures a value is the `NaN` number, without coercing it first, throwing otherwise. | +| [`requireNil`](requireNil.md) **New** | `Null | Undefined` | Ensures a value is `null` or `undefined`, throwing otherwise. | +| [`requireNonArray`](requireNonArray.md) **New** | `Any` | Ensures a value is **not** an `Array`, throwing `IllegalArgumentException` otherwise. | +| [`requireNonBoolean`](requireNonBoolean.md) **New** | `Any` | Ensures a value is **not** a boolean, throwing `IllegalArgumentException` otherwise. | +| [`requireNonDouble`](requireNonDouble.md) **New** | `Any` | Ensures a value is **not** a finite number carrying a fractional part, throwing otherwise; a synonym of `requireNonFloat`. | +| [`requireNonEmpty`](requireNonEmpty.md) **New** | `Any` | Ensures a value is **not** empty, throwing `IllegalArgumentException` otherwise. | +| [`requireNonFloat`](requireNonFloat.md) **New** | `Any` | Ensures a value is **not** a finite number carrying a fractional part, throwing otherwise. | +| [`requireNonInteger`](requireNonInteger.md) **New** | `Any` | Ensures a value is **not** an integer, throwing otherwise. | +| [`requireNonNaN`](requireNonNaN.md) **New** | `Any` | Ensures a value is **not** the `NaN` number, throwing otherwise. | +| [`requireNonSafeInteger`](requireNonSafeInteger.md) **New** | `Any` | Ensures a value is **not** a safe integer, throwing otherwise. | +| [`requireSafeInteger`](requireSafeInteger.md) **New** | `Number` | Ensures a value is a safe integer (exactly representable as an IEEE-754 double), throwing otherwise. | +| [`requireSymbol`](requireSymbol.md) **New** | `Symbol` | Ensures a value is a `Symbol`, throwing `IllegalArgumentException` otherwise. | +| [`requireNonEmptyString`](requireNonEmptyString.md) | `String` | Ensures a string is not empty, otherwise throws an exception. | +| [`requireNonException`](requireNonException.md) **New** | `Any` | Ensures a value is **not** an `Exception`, throwing `IllegalArgumentException` otherwise. | +| [`requireNonFunction`](requireNonFunction.md) **New** | `Any` | Ensures a value is **not** a function, throwing `IllegalArgumentException` otherwise. | +| [`requireNonFunctionLike`](requireNonFunctionLike.md) **New** | `Any` | Ensures a value is **not** callable, throwing `IllegalArgumentException` otherwise. | +| [`requireNoNilElements`](requireNoNilElements.md) **New** | `Array` | Throws `IllegalArgumentException` if an array, `Set` or `Map` holds a `null` or `undefined` element. | +| [`requireNonLength`](requireNonLength.md) **New** | `Any` | Ensures a value is **not** a valid array-like length, throwing `IllegalArgumentException` otherwise. | +| [`requireNonNil`](requireNonNil.md) **New** | `Any` | Ensures a value is neither `null` nor `undefined`, throwing `IllegalArgumentException`. | +| [`requireNonNull`](requireNonNull.md) | `any` | Ensures a value is not `null`, otherwise throws an exception. | +| [`requireNonNumber`](requireNonNumber.md) **New** | `Any` | Ensures a value is **not** a number, throwing `IllegalArgumentException` otherwise. | +| [`requireNonNumberLike`](requireNonNumberLike.md) **New** | `Any` | Ensures a value is **not** numeric in a broader sense, throwing `IllegalArgumentException` otherwise. | +| [`requireNonObject`](requireNonObject.md) **New** | `Any` | Ensures a value is **not** an `Object`, throwing `IllegalArgumentException` otherwise. | +| [`requireNonObjectLike`](requireNonObjectLike.md) **New** | `Any` | Ensures a value is **not** object-like (functions included), throwing `IllegalArgumentException` otherwise. | +| [`requireNonRegExp`](requireNonRegExp.md) **New** | `Any` | Ensures a value is **not** a regular expression, throwing `IllegalArgumentException` otherwise. | +| [`requireNonScalar`](requireNonScalar.md) **New** | `Any` | Ensures a value is **not** a scalar primitive, throwing `IllegalArgumentException` otherwise. | +| [`requireNonString`](requireNonString.md) **New** | `Any` | Ensures a value is **not** a string, throwing `IllegalArgumentException` otherwise. | +| [`requireNonSymbol`](requireNonSymbol.md) **New** | `Any` | Ensures a value is **not** a `Symbol`, throwing `IllegalArgumentException` otherwise. | +| [`requireNonUndefined`](requireNonUndefined.md) **New** | `Any` | Ensures a value is **not** `undefined`, throwing `IllegalArgumentException` otherwise. | +| [`requireNull`](requireNull.md) **New** | `Null` | Ensures a value is `null`, throwing `IllegalArgumentException` otherwise. | +| [`requireNumber`](requireNumber.md) **New** | `Number` | Ensures a value is a number, throwing `IllegalArgumentException` otherwise. | +| [`requireNumberLike`](requireNumberLike.md) **New** | `Number | String` | Ensures a value is numeric in a broader sense (a number or a numeric string), throwing otherwise. | +| [`requireObject`](requireObject.md) **New** | `Object` | Ensures a value is an `Object`, throwing `IllegalArgumentException` otherwise. | +| [`requireObjectLike`](requireObjectLike.md) **New** | `Object` | Ensures a value is object-like (functions included), throwing `IllegalArgumentException` otherwise. | +| [`requireRegExp`](requireRegExp.md) **New** | `RegExp` | Ensures a value is a regular expression, throwing `IllegalArgumentException` otherwise. | +| [`requireScalar`](requireScalar.md) **New** | `Scalar` | Ensures a value is a scalar primitive, throwing `IllegalArgumentException` otherwise. | +| [`requireState`](requireState.md) **New** | `void` | Throws `IllegalStateException` when a condition does not hold. | +| [`requireString`](requireString.md) | `String` | Ensures a value is a string, otherwise throws an exception. | +| [`requireUndefined`](requireUndefined.md) **New** | `Undefined` | Ensures a value is `undefined`, throwing `IllegalArgumentException` otherwise. | +| [`requireUrl`](requireUrl.md) **New** | `String` | Ensures a value is a properly formatted URL, throwing otherwise. | +| [`requireValidEmail`](requireValidEmail.md) | `String` | Ensures a string is a valid email, otherwise throws an exception. | +| [`requireValidLocale`](requireValidLocale.md) **New** | `String` | Ensures a string is a valid locale code, throwing otherwise. | +| [`requireValidSlug`](requireValidSlug.md) **New** | `String` | Ensures a string is a valid slug, throwing otherwise. | +| [`requireValidVersion`](requireValidVersion.md) **New** | `String` | Ensures a string is a valid version, throwing otherwise. | +| [`requireVersionCompatible`](requireVersionCompatible.md) **New** | `String` | Ensures one version is at least another, throwing otherwise. | +| [`retry`](retry.md) **New** | `T` | Calls a function until it succeeds, waiting longer between each failure. | +| [`setPath`](setPath.md) **New** | `Object` | Writes a nested property by path, creating missing levels and refusing prototype keys. | +| [`StopWatch`](StopWatch.md) **New** | `StopWatch` | Times a sequence of named tasks and prints a breakdown. | +| [`stringifyJson`](stringifyJson.md) | `String` | Safely converts an object to a JSON string. | +| [`toCamelCase`](toCamelCase.md) | `String` | Converts a string to `camelCase`. | +| [`toInteger`](toInteger.md) | `Number \| null` | Converts a value to an integer, returning `null` on failure. | +| [`toKebabCase`](toKebabCase.md) | `String` | Converts a string to `kebab-case`. | +| [`toLowerCase`](toLowerCase.md) | `String` | Converts a string to lowercase. | +| [`toProperCase`](toProperCase.md) | `String` | Converts a string to Proper Case (capitalizing the first letter of each word). | +| [`toSnakeCase`](toSnakeCase.md) | `String` | Converts a string to `snake_case`. | +| [`toUpperCase`](toUpperCase.md) | `String` | Converts a string to uppercase. | +| [`transpose`](transpose.md) | `Array` | Flips a 2D array over its diagonal (swaps rows and columns). | +| [`unique`](unique.md) **New** | `Array` | Removes duplicates from an array, keeping the first occurrence of each value. | +| [`versionCompare`](versionCompare.md) | `Number` | Compares two version strings, returning -1, 0, or 1. | +| [`without`](without.md) **New** | `Array` | Excludes the given values from an array, comparing with `SameValueZero`. | diff --git a/package-lock.json b/package-lock.json index c913f1ef..ab3f4ce5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -22,17 +22,18 @@ "@eslint/js": "^9.39.2", "@eslint/json": "^0.14.0", "@eslint/markdown": "^7.5.1", + "@stylistic/eslint-plugin": "^6.0.1", "@types/eslint-plugin-security": "^3.0.1", - "@types/google-apps-script": "^2.0.12", + "@types/google-apps-script": "^2.0.15", "@types/node": "^25.0.9", "@vitest/coverage-v8": "^4.1.12", "eslint": "^9.39.2", "eslint-config-prettier": "^10.1.8", "eslint-plugin-googleappsscript": "^1.0.5", "eslint-plugin-jsdoc": "^62.8.0", - "eslint-plugin-security": "^4.0.1", + "eslint-plugin-security": "^4.2.1", "husky": "^9.1.7", - "prettier": "^3.8.0", + "prettier": "^3.10.1", "reflect-metadata": "^0.2.2", "typescript": "^5.9.3", "typescript-eslint": "^8.73.0", @@ -734,6 +735,66 @@ "dev": true, "license": "MIT" }, + "node_modules/@stylistic/eslint-plugin": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin/-/eslint-plugin-6.0.1.tgz", + "integrity": "sha512-7nyi2RmGIuzBYGq5C8cFaoQsh+COfo6oHMWCygzg2iaqJJ4RDThaKCMYRkkOUAQWv80R7sbBbpuKZfulH7bFcw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.10.1", + "@typescript-eslint/types": "^8.72.2", + "@typescript-eslint/visitor-keys": "^8.72.2", + "espree": "^11.2.0", + "picomatch": "^4.0.7" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "peerDependencies": { + "eslint": "^9.0.0 || ^10.0.0", + "oxlint": "^1.55.0" + }, + "peerDependenciesMeta": { + "eslint": { + "optional": true + }, + "oxlint": { + "optional": true + } + } + }, + "node_modules/@stylistic/eslint-plugin/node_modules/eslint-visitor-keys": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-5.0.1.tgz", + "integrity": "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@stylistic/eslint-plugin/node_modules/espree": { + "version": "11.2.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-11.2.0.tgz", + "integrity": "sha512-7p3DrVEIopW1B1avAGLuCSh1jubc01H2JHc8B4qqGblmg5gI9yumBgACjWo4JlIc04ufug4xJ3SQI8HkS/Rgzw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.16.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^5.0.1" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, "node_modules/@types/chai": { "version": "5.2.3", "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz", @@ -791,9 +852,9 @@ "license": "MIT" }, "node_modules/@types/google-apps-script": { - "version": "2.0.12", - "resolved": "https://registry.npmjs.org/@types/google-apps-script/-/google-apps-script-2.0.12.tgz", - "integrity": "sha512-k6qjm5tG0HNsnn6WFwj0+1mqUesuJjOylb4Eer4u5vYtP9ITYg96V6tNegAgDXPl9aK8RRvx6U7n3f2HEckmXQ==", + "version": "2.0.15", + "resolved": "https://registry.npmjs.org/@types/google-apps-script/-/google-apps-script-2.0.15.tgz", + "integrity": "sha512-Mmz0zPNG6airLVK1KDy7sgU26HYhSdooOd5riBWMYk5iLel8jCeQu4EaOg7JIwMdEFhad/pNEeLpMt2dPlgnxQ==", "dev": true, "license": "MIT" }, @@ -1746,9 +1807,9 @@ } }, "node_modules/eslint-plugin-security": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/eslint-plugin-security/-/eslint-plugin-security-4.0.1.tgz", - "integrity": "sha512-/lZCkOxPOWaf1jXAqgICrS8St3BMBccIPvhOSUYuV6VCr1o5nFVG998FnTLt6w2Nxb8Uo0nM8fzmnhp+GY/aEg==", + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-plugin-security/-/eslint-plugin-security-4.2.1.tgz", + "integrity": "sha512-iF95SSqdSUVTvB7srNXoNeTQIqwfALTn9nmoqJyixSIKqEydlW01Cqb7xNveqE4Zd6YWBoQICQ4FH9NkR1byDg==", "dev": true, "license": "Apache-2.0", "dependencies": { @@ -3720,9 +3781,9 @@ } }, "node_modules/prettier": { - "version": "3.8.1", - "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.1.tgz", - "integrity": "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg==", + "version": "3.10.1", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.10.1.tgz", + "integrity": "sha512-70vp3ZUYoPlFbF9uiTdXHUUCGEIp7d4+6p+8DYbkm2jP7x/3i/paXVF6dopSI3zd/CEitrZN1rc4i85xWmmXlg==", "dev": true, "license": "MIT", "bin": { diff --git a/package.json b/package.json index ab9f5963..99dab1f5 100644 --- a/package.json +++ b/package.json @@ -105,17 +105,18 @@ "@eslint/js": "^9.39.2", "@eslint/json": "^0.14.0", "@eslint/markdown": "^7.5.1", + "@stylistic/eslint-plugin": "^6.0.1", "@types/eslint-plugin-security": "^3.0.1", - "@types/google-apps-script": "^2.0.12", + "@types/google-apps-script": "^2.0.15", "@types/node": "^25.0.9", "@vitest/coverage-v8": "^4.1.12", "eslint": "^9.39.2", "eslint-config-prettier": "^10.1.8", "eslint-plugin-googleappsscript": "^1.0.5", "eslint-plugin-jsdoc": "^62.8.0", - "eslint-plugin-security": "^4.0.1", + "eslint-plugin-security": "^4.2.1", "husky": "^9.1.7", - "prettier": "^3.8.0", + "prettier": "^3.10.1", "reflect-metadata": "^0.2.2", "typescript": "^5.9.3", "typescript-eslint": "^8.73.0", diff --git a/scripts/docs/author-batch.mjs b/scripts/docs/author-batch.mjs index 9342bbd2..66644b21 100644 --- a/scripts/docs/author-batch.mjs +++ b/scripts/docs/author-batch.mjs @@ -60,7 +60,10 @@ for (const file of readdirSync(AUTHORED).sort()) { const dir = join(ROOT, "docs/content", language.code, "functions"); mkdirSync(dir, { recursive: true }); - writeFileSync(join(dir, `${name}.json`), `${JSON.stringify(content, null, 2)}\n`); + + const json = JSON.stringify(content, null, 2); + + writeFileSync(join(dir, `${name}.json`), `${json}\n`); written += 1; } } diff --git a/scripts/docs/author-exceptions.mjs b/scripts/docs/author-exceptions.mjs index 354927a3..f196e752 100644 --- a/scripts/docs/author-exceptions.mjs +++ b/scripts/docs/author-exceptions.mjs @@ -260,7 +260,10 @@ for (const [name, data] of Object.entries(CLASSES)) { const dir = join(ROOT, "docs/content", language.code, "functions"); mkdirSync(dir, { recursive: true }); - writeFileSync(join(dir, `${name}.json`), `${JSON.stringify(content, null, 2)}\n`); + + const json = JSON.stringify(content, null, 2); + + writeFileSync(join(dir, `${name}.json`), `${json}\n`); written += 1; } } diff --git a/scripts/docs/author-guards.mjs b/scripts/docs/author-guards.mjs index 1e5d3c4e..5ae326f6 100644 --- a/scripts/docs/author-guards.mjs +++ b/scripts/docs/author-guards.mjs @@ -70,8 +70,8 @@ const TEMPLATES = { requireNonSummary: (s) => `Returns the value after checking that it is not ${s.non}.`, family: "`isX` and `nonX` answer a question and never interrupt control flow; `requireX` and `requireNonX` hand the value back or throw. The scheme is explained in [](validation-conventions.md).", - negation: (name) => - `\`${name}(value)\` is the same test as \`!${name.replace(/^non/, "is")}(value)\`, written so that a guard clause reads as a sentence rather than as a negation.`, + negation: (name, positive) => + `\`${name}(value)\` is the same test as \`!${positive}(value)\`, written so that a guard clause reads as a sentence rather than as a negation.`, valueParam: "The value to check.", validateParam: "The value to validate.", messageParam: () => "The message of the exception. A default is used when omitted.", @@ -98,8 +98,8 @@ const TEMPLATES = { requireNonSummary: (s) => `Возвращает значение, убедившись, что оно не является ${s.non}.`, family: "`isX` и `nonX` отвечают на вопрос и никогда не прерывают выполнение; `requireX` и `requireNonX` возвращают значение или выбрасывают исключение. Схема разобрана в [](validation-conventions.md).", - negation: (name) => - `\`${name}(value)\` — та же проверка, что и \`!${name.replace(/^non/, "is")}(value)\`, записанная так, чтобы охранное условие читалось как утверждение, а не как отрицание.`, + negation: (name, positive) => + `\`${name}(value)\` — та же проверка, что и \`!${positive}(value)\`, записанная так, чтобы охранное условие читалось как утверждение, а не как отрицание.`, valueParam: "Проверяемое значение.", validateParam: "Значение, которое нужно проверить.", messageParam: () => @@ -128,8 +128,8 @@ const TEMPLATES = { requireNonSummary: (s) => `Повертає значення, переконавшись, що воно не є ${s.non}.`, family: "`isX` та `nonX` відповідають на питання й ніколи не переривають виконання; `requireX` і `requireNonX` повертають значення або викидають виняток. Схему розібрано в [](validation-conventions.md).", - negation: (name) => - `\`${name}(value)\` — та сама перевірка, що й \`!${name.replace(/^non/, "is")}(value)\`, записана так, щоб охоронна умова читалася як твердження, а не як заперечення.`, + negation: (name, positive) => + `\`${name}(value)\` — та сама перевірка, що й \`!${positive}(value)\`, записана так, щоб охоронна умова читалася як твердження, а не як заперечення.`, valueParam: "Значення, що перевіряється.", validateParam: "Значення, яке потрібно перевірити.", messageParam: () => @@ -158,8 +158,8 @@ const TEMPLATES = { `Gibt den Wert zurück, nachdem geprüft wurde, dass er nicht ${s.non} ist.`, family: "`isX` und `nonX` beantworten eine Frage und unterbrechen den Ablauf nie; `requireX` und `requireNonX` geben den Wert zurück oder werfen. Das Schema erklärt [](validation-conventions.md).", - negation: (name) => - `\`${name}(value)\` ist dieselbe Prüfung wie \`!${name.replace(/^non/, "is")}(value)\`, so geschrieben, dass eine Wächterklausel sich wie ein Satz liest und nicht wie eine Verneinung.`, + negation: (name, positive) => + `\`${name}(value)\` ist dieselbe Prüfung wie \`!${positive}(value)\`, so geschrieben, dass eine Wächterklausel sich wie ein Satz liest und nicht wie eine Verneinung.`, valueParam: "Der zu prüfende Wert.", validateParam: "Der zu validierende Wert.", messageParam: () => @@ -188,8 +188,8 @@ const TEMPLATES = { requireNonSummary: (s) => `Renvoie la valeur après avoir vérifié qu'elle n'est pas ${s.non}.`, family: "`isX` et `nonX` répondent à une question sans jamais interrompre le flot ; `requireX` et `requireNonX` rendent la valeur ou lèvent. Le schéma est expliqué dans [](validation-conventions.md).", - negation: (name) => - `\`${name}(value)\` est le même test que \`!${name.replace(/^non/, "is")}(value)\`, écrit pour qu'une clause de garde se lise comme une phrase plutôt que comme une négation.`, + negation: (name, positive) => + `\`${name}(value)\` est le même test que \`!${positive}(value)\`, écrit pour qu'une clause de garde se lise comme une phrase plutôt que comme une négation.`, valueParam: "La valeur à vérifier.", validateParam: "La valeur à valider.", messageParam: () => "Le message de l'exception. À défaut, un message par défaut est utilisé.", @@ -301,7 +301,11 @@ for (const [module, subjects] of Object.entries(MODULES)) { if (present.non) { write(language.code, members.non, { summary: t.nonSummary(s), - description: [t.negation(members.non), s.note, t.family], + description: [ + t.negation(members.non, members.non.replace(/^non/, "is")), + s.note, + t.family + ], params: { value: t.valueParam }, returns: t.nonReturns(s), throws: {}, @@ -396,7 +400,10 @@ function write(code, name, content) { const dir = join(ROOT, "docs/content", code, "functions"); mkdirSync(dir, { recursive: true }); - writeFileSync(join(dir, `${name}.json`), `${JSON.stringify(content, null, 2)}\n`); + + const json = JSON.stringify(content, null, 2); + + writeFileSync(join(dir, `${name}.json`), `${json}\n`); written.push(`${code}/${name}`); } diff --git a/scripts/docs/finalize-site.mjs b/scripts/docs/finalize-site.mjs index 09991f3f..7b5af539 100644 --- a/scripts/docs/finalize-site.mjs +++ b/scripts/docs/finalize-site.mjs @@ -46,7 +46,9 @@ function pagesOf(dir, base = dir) { const full = join(dir, entry); if (statSync(full).isDirectory()) { - if (SKIP.has(entry) || (dir === base && CODES.has(entry))) { + const isLanguageRoot = dir === base && CODES.has(entry); + + if (SKIP.has(entry) || isLanguageRoot) { continue; } @@ -90,13 +92,19 @@ function injections(language) { * that runs none, both still see every translation. */ function languageRow(language, page, present) { - const links = present.map((other) => - other === language - ? `${other.name}` - : `${other.name}` - ); + const links = present.map((other) => { + if (other === language) { + return `${other.name}`; + } + + const href = urlOf(other, page); + + return `${other.name}`; + }); + + const row = links.join(' '); - return ``; + return ``; } const pages = pagesOf(root); @@ -121,10 +129,11 @@ for (const page of pages) { } const alternates = present - .map( - (language) => - `` - ) + .map((language) => { + const href = urlOf(language, page); + + return ``; + }) .join("\n "); const xDefault = ``; @@ -143,13 +152,25 @@ for (const page of pages) { const injected = injections(language); if (injected.head && !html.includes("SoftwareSourceCode")) { - html = `${html.slice(0, html.indexOf(""))}${injected.head}\n${html.slice(html.indexOf(""))}`; + const headEnd = html.indexOf(""); + + const beforeHead = html.slice(0, headEnd); + + const fromHead = html.slice(headEnd); + + html = `${beforeHead}${injected.head}\n${fromHead}`; } if (!html.includes('rel="alternate" hreflang=')) { - const canonical = ``; + const href = urlOf(language, page); + + const canonical = ``; - html = `${html.slice(0, at)} ${canonical}\n ${alternates}\n ${xDefault}\n${html.slice(at)}`; + const beforeHead = html.slice(0, at); + + const fromHead = html.slice(at); + + html = `${beforeHead} ${canonical}\n ${alternates}\n ${xDefault}\n${fromHead}`; linked += 1; } @@ -167,7 +188,13 @@ for (const page of pages) { if (article) { const at = html.indexOf(article[0]) + article[0].length; - html = `${html.slice(0, at)}${languageRow(language, page, present)}${html.slice(at)}`; + const row = languageRow(language, page, present); + + const before = html.slice(0, at); + + const after = html.slice(at); + + html = `${before}${row}${after}`; } } @@ -182,7 +209,11 @@ for (const page of pages) { const at = article === -1 ? html.lastIndexOf("