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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@

-> أُنجزت هذه الترجمة بمساعدة الذكاء الاصطناعي انطلاقًا من [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™ @@ -23,6 +23,8 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

@@ -215,16 +217,16 @@ console.log(rangeInfo.endColumnIndex); // 2

-| Script | الوصف | -| :------------------- | :------------------------------------------------------------ | -| `npm run build` | ينظّف المجلد `dist` ويترجم شيفرة TypeScript المصدرية. | -| `npm run dev` | يشغّل Vitest في وضع المراقبة. | -| `npm test` | يشغّل مجموعة الاختبارات كاملةً مرة واحدة. | -| `npm run type:check` | يتحقق من أنواع المشروع دون إنتاج مخرجات. | -| `npm run lint` | يفحص الشيفرة باستخدام ESLint. | -| `npm run lint:fix` | يفحص الشيفرة ويصلح تلقائيًا ما أمكن. | -| `npm run format` | يتحقق من التنسيق باستخدام Prettier. | -| `npm run format:fix` | ينسّق الشيفرة باستخدام Prettier. | +| Script | الوصف | +| :------------------- | :--------------------------------------------------------- | +| `npm run build` | ينظّف المجلد `dist` ويترجم شيفرة TypeScript المصدرية. | +| `npm run dev` | يشغّل Vitest في وضع المراقبة. | +| `npm test` | يشغّل مجموعة الاختبارات كاملةً مرة واحدة. | +| `npm run type:check` | يتحقق من أنواع المشروع دون إنتاج مخرجات. | +| `npm run lint` | يفحص الشيفرة باستخدام ESLint. | +| `npm run lint:fix` | يفحص الشيفرة ويصلح تلقائيًا ما أمكن. | +| `npm run format` | يتحقق من التنسيق باستخدام Prettier. | +| `npm run format:fix` | ينسّق الشيفرة باستخدام Prettier. | | `npm run prepare` | يُعدّ خطافات Git الخاصة بـ Husky (يعمل تلقائيًا بعد التثبيت). |
@@ -289,7 +291,7 @@ npm run dev | :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------- | | [Google Apps Script module](https://bootgs.github.io/utils/reference-appsscript.html) | Sheets وSlides وAdmin SDK وDrive وDocs وForms، وطلبات الشبكة، وفئات واجهة المستخدم المدمجة | | [Base utilities](https://bootgs.github.io/utils/reference-base.html) | فحص الأنواع والتحقق، ومعالجة السلاسل النصية والمصفوفات والكائنات، والتعامل مع JSON وHTML | -| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | فئات الاستثناءات ذات الأنواع المحددة وما الذي يطلق كلًّا منها | +| [Exceptions](https://bootgs.github.io/utils/reference-exception.html) | فئات الاستثناءات ذات الأنواع المحددة وما الذي يطلق كلًّا منها | | [`path` module](https://bootgs.github.io/utils/reference-path.html) | مسارات الملفات وعناوين URL | | [Abstracts and interfaces](https://bootgs.github.io/utils/reference-abstracts.html) | لبنات بناء مشتركة | diff --git a/docs/readme/README.cs.md b/docs/readme/README.cs.md index b88262d6..04c90619 100644 --- a/docs/readme/README.cs.md +++ b/docs/readme/README.cs.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** | [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) -> Tento překlad vznikl s pomocí AI z [README.md](../../README.md) pro verzi 2.1.1. Referenční verzí je anglické README; opravy jsou vítány — viz [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations). +> Tento překlad vznikl s pomocí AI z [README.md](../../README.md) pro verzi 3.0.0. Referenční verzí je anglické README; opravy jsou vítány — viz [CONTRIBUTING.md](../../CONTRIBUTING.md#readme-translations). # Utility pro Google Apps Script™ @@ -19,6 +19,8 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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 @@ CodeQL OpenSSF Scorecard REUSE status + OpenSSF Best Practices + OpenSSF Baseline

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("") : article; if (at !== -1) { - html = `${html.slice(0, at)}${notice}\n${html.slice(at)}`; + const before = html.slice(0, at); + + const after = html.slice(at); + + html = `${before}${notice}\n${after}`; } } @@ -200,12 +231,15 @@ const sitemap = [ for (const { page, present } of entries) { for (const language of present) { sitemap.push(" "); - sitemap.push(` ${urlOf(language, page)}`); + + const loc = urlOf(language, page); + + sitemap.push(` ${loc}`); for (const other of present) { - sitemap.push( - ` ` - ); + const href = urlOf(other, page); + + sitemap.push(` `); } sitemap.push(` `); diff --git a/scripts/docs/generate-topics.mjs b/scripts/docs/generate-topics.mjs index 710f3646..c97fd1d3 100644 --- a/scripts/docs/generate-topics.mjs +++ b/scripts/docs/generate-topics.mjs @@ -26,7 +26,6 @@ import { mkdirSync, readdirSync, readFileSync, - rmSync, statSync, writeFileSync } from "node:fs"; @@ -164,11 +163,19 @@ function commentToText(comment) { } return comment - .map((part) => - ts.isJSDocLink(part) || ts.isJSDocLinkCode(part) || ts.isJSDocLinkPlain(part) - ? `{@link ${part.name?.getText() ?? ""}${part.text ?? ""}}` - : part.text - ) + .map((part) => { + const isLink = ts.isJSDocLink(part) || ts.isJSDocLinkCode(part) || ts.isJSDocLinkPlain(part); + + if (!isLink) { + return part.text; + } + + const name = part.name?.getText() ?? ""; + + const text = part.text ?? ""; + + return `{@link ${name}${text}}`; + }) .join(""); } @@ -225,12 +232,13 @@ function thrownClasses(nodes) { } const visit = (child) => { - if ( + const throwsNew = ts.isThrowStatement(child) && child.expression && ts.isNewExpression(child.expression) && - child.expression.expression - ) { + child.expression.expression; + + if (throwsNew) { const name = child.expression.expression.getText(); if (!found.includes(name)) { @@ -361,12 +369,14 @@ function signatureOf(nodes, source, kind) { const end = node.body ? node.body.getStart(source, false) : node.getEnd(); - return `${source.text + const declaration = source.text .slice(start, end) .trim() .replace(/\s*\{$/, "") .replace(/^export\s+/, "") - .replace(/\s+/g, " ")};`; + .replace(/\s+/g, " "); + + return `${declaration};`; }) .join("\n"); } @@ -499,7 +509,7 @@ function escapeCell(text) { return text.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\s+/g, " ").trim(); } -function renderPage(entry, language, content, sourceContent, pages, thrownBy) { +function renderPage({ entry, language, content, sourceContent, pages, thrownBy }) { const strings = language.strings; const jsdoc = entry.jsdoc; @@ -521,18 +531,23 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { lines.push(""); lines.push(`# ${entry.name}`); lines.push(""); - lines.push(`${summary.replace(/[<>]/g, "")}`); + + const plainSummary = summary.replace(/[<>]/g, ""); + + const title = entry.kind === "function" ? `${entry.name}()` : entry.name; + + const since = jsdoc.since ? ` · ${strings.since}: ${jsdoc.since}` : ""; + + const deprecated = jsdoc.deprecated ? ` · ${strings.deprecated}` : ""; + + lines.push(`${plainSummary}`); lines.push(""); lines.push( - `${entry.kind === "function" ? `${entry.name}()` : entry.name} — ${summary.replace(/[<>]/g, "")} @bootgs/utils, ${language.name}.` + `${title} — ${plainSummary} @bootgs/utils, ${language.name}.` ); lines.push(""); lines.push(""); - lines.push( - `

${strings.module}: ${entry.module}${jsdoc.since ? ` · ${strings.since}: ${jsdoc.since}` : ""}${ - jsdoc.deprecated ? ` · ${strings.deprecated}` : "" - }

` - ); + lines.push(`

${strings.module}: ${entry.module}${since}${deprecated}

`); lines.push("
"); lines.push(""); @@ -542,9 +557,9 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { } if (jsdoc.deprecated) { - lines.push( - `> **${strings.deprecated}.** ${resolveLinks(jsdoc.deprecated, pages).replace(/\n/g, " ")}` - ); + const reason = resolveLinks(jsdoc.deprecated, pages).replace(/\n/g, " "); + + lines.push(`> **${strings.deprecated}.** ${reason}`); lines.push(""); } @@ -577,11 +592,19 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { flags.push(`\`= ${param.default}\``); } - lines.push( - `| \`${param.rest ? "..." : ""}${param.name}\`${flags.length ? ` ${flags.join(" ")}` : ""} | ${ - param.type ? `\`${escapeCell(param.type)}\`` : "—" - } | ${escapeCell(resolveLinks(described, pages)) || "—"} |` - ); + const spread = param.rest ? "..." : ""; + + const flagList = flags.join(" "); + + const flagText = flags.length ? ` ${flagList}` : ""; + + const escapedType = param.type ? escapeCell(param.type) : ""; + + const typeCell = param.type ? `\`${escapedType}\`` : "—"; + + const descriptionCell = escapeCell(resolveLinks(described, pages)) || "—"; + + lines.push(`| \`${spread}${param.name}\`${flagText} | ${typeCell} | ${descriptionCell} |`); } lines.push(""); @@ -598,7 +621,10 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { lines.push(`## ${strings.returns}`); lines.push(""); - lines.push(shown ? `\`${shown}\`${described ? ` — ${described}` : ""}` : described); + + const suffix = described ? ` — ${described}` : ""; + + lines.push(shown ? `\`${shown}\`${suffix}` : described); if (predicate) { lines.push(""); @@ -658,9 +684,13 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { pending.push(...(thrownBy.get(called)?.calls ?? [])); } - if (reachable.size > 0 && !reachable.has(type) && !BUILT_IN_ERRORS.has(type)) { + const isKnownType = reachable.has(type) || BUILT_IN_ERRORS.has(type); + + if (reachable.size > 0 && !isKnownType) { + const reachableList = [...reachable].join(", "); + console.warn( - ` ${entry.name}: prose says it throws ${type}; reachable from the code: ${[...reachable].join(", ")}` + ` ${entry.name}: prose says it throws ${type}; reachable from the code: ${reachableList}` ); } @@ -676,7 +706,11 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { for (const [type, whens] of conditions) { for (const when of whens) { - lines.push(`| \`${escapeCell(type)}\` | ${escapeCell(resolveLinks(when, pages)) || "—"} |`); + const typeCell = escapeCell(type); + + const whenCell = escapeCell(resolveLinks(when, pages)) || "—"; + + lines.push(`| \`${typeCell}\` | ${whenCell} |`); } } @@ -728,7 +762,9 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { .replace(/^\((.*)\)$/s, "$1"); if (caption && !example.title) { - lines.push(`_${caption.replace(/\s+/g, " ")}_`); + const flatCaption = caption.replace(/\s+/g, " "); + + lines.push(`_${flatCaption}_`); lines.push(""); } @@ -749,7 +785,9 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { const short = String(target).replace(/^.*[.#]/, ""); - if (!pages.has(short) || short === entry.name || seen.has(short)) { + const isSkipped = short === entry.name || seen.has(short); + + if (!pages.has(short) || isSkipped) { continue; } @@ -776,7 +814,11 @@ function renderPage(entry, language, content, sourceContent, pages, thrownBy) { const [, label, url] = link; - if (url.toLowerCase().endsWith(`/${entry.name.toLowerCase()}.html`) || seen.has(url)) { + const ownSlug = entry.name.toLowerCase(); + + const ownPage = `/${ownSlug}.html`; + + if (url.toLowerCase().endsWith(ownPage) || seen.has(url)) { continue; } @@ -855,11 +897,15 @@ function localiseTables(english, translated, language, summaries) { const cells = row.split("|").slice(1, -1); if (index === 0) { - return `| ${cells.map((cell) => label(cell.trim(), strings)).join(" | ")} |`; + const headings = cells.map((cell) => label(cell.trim(), strings)).join(" | "); + + return `| ${headings} |`; } if (index === 1) { - return `|${cells.map(() => " :--- ").join("|")}|`; + const alignments = cells.map(() => " :--- ").join("|"); + + return `|${alignments}|`; } if (cells.length < 2) { @@ -871,14 +917,20 @@ function localiseTables(english, translated, language, summaries) { const summary = name ? summaries.get(name) : null; if (!summary) { - return `|${cells.join("|")}|`; + const joined = cells.join("|"); + + return `|${joined}|`; } const localised = cells.slice(); - localised[localised.length - 1] = ` ${escapeCell(summary)} `; + const escapedSummary = escapeCell(summary); - return `|${localised.join("|")}|`; + localised[localised.length - 1] = ` ${escapedSummary} `; + + const joined = localised.join("|"); + + return `|${joined}|`; }) .join("\n") ); @@ -1012,9 +1064,11 @@ for (const language of LANGUAGES) { ) : translation; + const trimmedBody = body.trim(); + emit( join(topics, name), - await pretty(`${MARKER} Translated topic. -->\n\n${body.trim()}\n`, join(topics, name)) + await pretty(`${MARKER} Translated topic. -->\n\n${trimmedBody}\n`, join(topics, name)) ); continue; @@ -1024,11 +1078,13 @@ for (const language of LANGUAGES) { const withNotice = english.replace(/^(# .*\n)/, `$1\n> ${language.strings.englishNotice}\n`); + const trimmedNotice = withNotice.trim(); + untranslated.push(name); emit( join(topics, name), await pretty( - `${MARKER} Untranslated topic, shown in English. -->\n\n${withNotice.trim()}\n`, + `${MARKER} Untranslated topic, shown in English. -->\n\n${trimmedNotice}\n`, join(topics, name) ) ); @@ -1063,7 +1119,10 @@ for (const language of LANGUAGES) { emit( target, - await pretty(renderPage(entry, language, content, english, pages, thrownBy), target) + await pretty( + renderPage({ entry, language, content, sourceContent: english, pages, thrownBy }), + target + ) ); } @@ -1071,10 +1130,9 @@ for (const language of LANGUAGES) { } // 4. The reference tables of the source project point at the pages. -const tableLink = new RegExp( - `\\[\`(\\w+)\`\\]\\(${REPO.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/src/[^)]+\\)`, - "g" -); +const escapedRepo = REPO.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); + +const tableLink = new RegExp(`\\[\`(\\w+)\`\\]\\(${escapedRepo}/src/[^)]+\\)`, "g"); for (const topic of new Set(entries.map((entry) => entry.referenceTopic))) { const path = join(sourceRoot, "topics", topic); @@ -1130,7 +1188,9 @@ for (const language of LANGUAGES) { const total = entries.length + (language === SOURCE_LANGUAGE ? 0 : 15); - coverage.push(`| ${language.name} | ${total} | ${total - gaps.length} | ${gaps.length} |`); + const covered = total - gaps.length; + + coverage.push(`| ${language.name} | ${total} | ${covered} | ${gaps.length} |`); } coverage.push(""); @@ -1157,7 +1217,9 @@ if (CHECK && stale.length > 0) { } if (stale.length > 20) { - console.error(` … and ${stale.length - 20} more`); + const remaining = stale.length - 20; + + console.error(` … and ${remaining} more`); } process.exit(1); diff --git a/scripts/docs/site.mjs b/scripts/docs/site.mjs index 2badf3fc..237390b3 100644 --- a/scripts/docs/site.mjs +++ b/scripts/docs/site.mjs @@ -7,30 +7,8 @@ * language switcher is made once and lands in all five sites. */ -import { readFileSync } from "node:fs"; -import { fileURLToPath } from "node:url"; - import { LANGUAGES, SITE } from "./languages.mjs"; -/** - * The widget script, with this language's labels substituted in. - */ -function widget(language) { - const source = readFileSync( - fileURLToPath(new URL("./assets/search-widget.js", import.meta.url)), - "utf8" - ); - - const strings = JSON.stringify({ - hint: language.strings.searchHint, - missing: language.strings.searchMissing, - matches: language.strings.searchMatches, - empty: language.strings.searchEmpty - }); - - return source.replace("__ASU_STRINGS__", strings); -} - const ARTWORK = "https://darynamikhailenko.com/?utm_source=docs&utm_medium=footer&utm_campaign=apps-script-utils&utm_content=banner-artist-credit"; @@ -77,6 +55,12 @@ function settings(language, depth = 2) { } export function buildProfiles(language) { + const languageLinks = LANGUAGES.map( + (other) => ` ${other.name}` + ).join("\n"); + + const variables = settings(language); + return ` @@ -84,7 +68,7 @@ export function buildProfiles(language) { xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/build-profiles.xsd"> -${settings(language)} +${variables}
@@ -92,7 +76,7 @@ ${settings(language)} 2025–2026 Maksym Stoianov. Licensed under Apache-2.0. GitHub npm -${LANGUAGES.map((other) => ` ${other.name}`).join("\n")} +${languageLinks} Banner artwork: Daryna Mikhailenko
diff --git a/scripts/docs/sync-jsdoc-examples.mjs b/scripts/docs/sync-jsdoc-examples.mjs index 8f9ad956..cc4bac72 100644 --- a/scripts/docs/sync-jsdoc-examples.mjs +++ b/scripts/docs/sync-jsdoc-examples.mjs @@ -134,7 +134,9 @@ for (const file of listSources(SRC).sort()) { const blocks = statement.jsDoc ?? []; - if (!name || blocks.length === 0 || documented.has(name)) { + const isUndocumented = !name || blocks.length === 0; + + if (isUndocumented || documented.has(name)) { continue; } @@ -217,7 +219,9 @@ if (CHECK && stale.length > 0) { } if (stale.length > 20) { - console.error(` … and ${stale.length - 20} more`); + const remaining = stale.length - 20; + + console.error(` … and ${remaining} more`); } process.exit(1); diff --git a/scripts/docs/sync-jsdoc-links.mjs b/scripts/docs/sync-jsdoc-links.mjs index 16ce3668..caf4fa25 100644 --- a/scripts/docs/sync-jsdoc-links.mjs +++ b/scripts/docs/sync-jsdoc-links.mjs @@ -89,9 +89,11 @@ function referencesOf(text) { continue; } + const slug = kebab(klass); + urls.set( `Class ${klass}`, - `https://developers.google.com/apps-script/reference/${segment}/${kebab(klass)}` + `https://developers.google.com/apps-script/reference/${segment}/${slug}` ); } @@ -103,15 +105,18 @@ function isExported(node) { } function nameOf(statement) { - if ((ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement)) && statement.name) { + const isFunctionOrClass = ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement); + + if (isFunctionOrClass && statement.name) { return statement.name.getText(); } - if ( + const isTypeLike = ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement) || - ts.isEnumDeclaration(statement) - ) { + ts.isEnumDeclaration(statement); + + if (isTypeLike) { return statement.name.getText(); } @@ -142,7 +147,9 @@ for (const file of listSources(SRC).sort()) { const blocks = statement.jsDoc ?? []; - if (!name || blocks.length === 0 || documented.has(name)) { + const isUndocumented = !name || blocks.length === 0; + + if (isUndocumented || documented.has(name)) { continue; } @@ -155,7 +162,9 @@ for (const file of listSources(SRC).sort()) { // Writerside publishes every page in lower case, and GitHub Pages is // case-sensitive, so the link has to be lower case or it 404s. - const page = `${SITE}/${name.toLowerCase()}.html`; + const slug = name.toLowerCase(); + + const page = `${SITE}/${slug}.html`; const wanted = new Map([[`${name} on the documentation site`, page]]); @@ -265,7 +274,9 @@ if (CHECK && stale.length > 0) { } if (stale.length > 20) { - console.error(` … and ${stale.length - 20} more`); + const remaining = stale.length - 20; + + console.error(` … and ${remaining} more`); } process.exit(1); diff --git a/scripts/docs/verify-examples.mjs b/scripts/docs/verify-examples.mjs index 28c6b881..9b875db9 100644 --- a/scripts/docs/verify-examples.mjs +++ b/scripts/docs/verify-examples.mjs @@ -107,71 +107,80 @@ const used = new Set(); let skipped = 0; -for (const file of readdirSync(CONTENT).sort()) { - const content = JSON.parse(readFileSync(join(CONTENT, file), "utf8")); +/** + * Turns one example line into a test, or counts it as skipped when it cannot + * be checked. + */ +function addAssertion(name, line) { + const title = JSON.stringify(`${name}: ${line}`); - const name = file.replace(/\.json$/, ""); + const thrown = line.match(THROWS); - for (const example of content.examples ?? []) { - const body = example.body ?? ""; + const thrownArgs = thrown ? thrown[1].replace(/^[A-Za-z_$][\w$]*\(/, "").replace(/\)$/, "") : ""; - for (const block of body.matchAll(/```javascript\n([\s\S]*?)```/g)) { - for (const raw of block[1].split("\n")) { - const line = raw.trim(); + if (thrown && !evaluable(thrownArgs)) { + skipped += 1; - if (!line || line.startsWith("//")) { - continue; - } + return; + } - const thrown = line.match(THROWS); + if (thrown) { + assertions.push( + ` it(${title}, () => {\n expect(() => ${thrown[1]}).toThrow(${thrown[2]});\n });` + ); + used.add(thrown[2]); - if (thrown && !evaluable(thrown[1].replace(/^[A-Za-z_$][\w$]*\(/, "").replace(/\)$/, ""))) { - skipped += 1; + return; + } - continue; - } + const result = line.match(RESULT); - if (thrown) { - assertions.push( - ` it(${JSON.stringify(`${name}: ${line}`)}, () => {\n` + - ` expect(() => ${thrown[1]}).toThrow(${thrown[2]});\n });` - ); - used.add(thrown[2]); + if (!result) { + skipped += 1; - continue; - } + return; + } - const result = line.match(RESULT); + const expected = parseExpected(result[2]); - if (!result) { - skipped += 1; + const args = result[1].replace(/^[A-Za-z_$][\w$]*\(/, "").replace(/\)$/, ""); - continue; - } + if (expected === null || !evaluable(args)) { + skipped += 1; - const expected = parseExpected(result[2]); + return; + } + + // `requireX(value) // => value` documents identity, not a deep copy. + const call = result[1].match(/^([A-Za-z_$][\w$]*)\((.*)\)$/); - const args = result[1].replace(/^[A-Za-z_$][\w$]*\(/, "").replace(/\)$/, ""); + const identity = call && call[2].trim() === expected.trim(); - if (expected === null || !evaluable(args)) { - skipped += 1; + assertions.push( + identity + ? ` it(${title}, () => {\n` + + ` const value = ${expected};\n` + + ` expect(${call[1]}(value)).toBe(value);\n });` + : ` it(${title}, () => {\n expect(${result[1]}).toStrictEqual(${expected});\n });` + ); +} + +for (const file of readdirSync(CONTENT).sort()) { + const content = JSON.parse(readFileSync(join(CONTENT, file), "utf8")); - continue; - } + const name = file.replace(/\.json$/, ""); - // `requireX(value) // => value` documents identity, not a deep copy. - const call = result[1].match(/^([A-Za-z_$][\w$]*)\((.*)\)$/); + for (const example of content.examples ?? []) { + const body = example.body ?? ""; - const identity = call && call[2].trim() === expected.trim(); + for (const block of body.matchAll(/```javascript\n([\s\S]*?)```/g)) { + const lines = block[1] + .split("\n") + .map((raw) => raw.trim()) + .filter((line) => line && !line.startsWith("//")); - assertions.push( - identity - ? ` it(${JSON.stringify(`${name}: ${line}`)}, () => {\n` + - ` const value = ${expected};\n` + - ` expect(${call[1]}(value)).toBe(value);\n });` - : ` it(${JSON.stringify(`${name}: ${line}`)}, () => {\n` + - ` expect(${result[1]}).toStrictEqual(${expected});\n });` - ); + for (const line of lines) { + addAssertion(name, line); } } } diff --git a/scripts/docs/write-help-versions.mjs b/scripts/docs/write-help-versions.mjs index 466f235f..3342638d 100644 --- a/scripts/docs/write-help-versions.mjs +++ b/scripts/docs/write-help-versions.mjs @@ -53,8 +53,10 @@ const versions = [ })) ]; -writeFileSync(join(dir, "help-versions.json"), `${JSON.stringify(versions, null, 2)}\n`); +const versionsJson = JSON.stringify(versions, null, 2); -console.log( - `help-versions.json: ${versions.length} version(s) — ${versions.map((entry) => entry.version).join(", ")}` -); +writeFileSync(join(dir, "help-versions.json"), `${versionsJson}\n`); + +const versionList = versions.map((entry) => entry.version).join(", "); + +console.log(`help-versions.json: ${versions.length} version(s) — ${versionList}`); diff --git a/scripts/lib/three-way-merge.mjs b/scripts/lib/three-way-merge.mjs index bc93bead..3ee7f1ea 100644 --- a/scripts/lib/three-way-merge.mjs +++ b/scripts/lib/three-way-merge.mjs @@ -71,7 +71,9 @@ export function mergeEntries(ancestor, ours, theirs, compare) { const changedByThem = t.text !== entry.text; - if (changedByUs && changedByThem && o.text !== t.text) { + const changedByBoth = changedByUs && changedByThem; + + if (changedByBoth && o.text !== t.text) { return null; } diff --git a/scripts/merge-module-index.mjs b/scripts/merge-module-index.mjs index 6771776a..e96c6bef 100644 --- a/scripts/merge-module-index.mjs +++ b/scripts/merge-module-index.mjs @@ -177,7 +177,9 @@ function main() { const t = parse(theirs); - if (!a || !o || !t) { + const unparsed = !a || !o || !t; + + if (unparsed) { return fallback(); } diff --git a/scripts/merge-reference-tables.mjs b/scripts/merge-reference-tables.mjs index fd2e3f0b..8d0dee4e 100644 --- a/scripts/merge-reference-tables.mjs +++ b/scripts/merge-reference-tables.mjs @@ -78,7 +78,7 @@ function parse(text) { let heading = ""; - for (let i = 0; i < lines.length; ) { + for (let i = 0; i < lines.length;) { const title = HEADING.exec(lines[i]); if (title) { @@ -197,7 +197,9 @@ function main() { const t = parse(theirs); - if (!a || !o || !t) { + const unparsed = !a || !o || !t; + + if (unparsed) { return fallback(); } diff --git a/src/appsscript/admin/isAdmin.ts b/src/appsscript/admin/isAdmin.ts index 0b8196bd..a07f4920 100644 --- a/src/appsscript/admin/isAdmin.ts +++ b/src/appsscript/admin/isAdmin.ts @@ -34,6 +34,8 @@ export function isAdmin(): boolean { return !!user.isAdmin; } catch (err: unknown) { + // The error is swallowed into `false`; the Apps Script log is its only trace. + // eslint-disable-next-line no-console console.warn(`[Error]: ${err}`); } diff --git a/src/appsscript/base/getByteSize.ts b/src/appsscript/base/getByteSize.ts index 10ca35e8..8db7748d 100644 --- a/src/appsscript/base/getByteSize.ts +++ b/src/appsscript/base/getByteSize.ts @@ -29,6 +29,6 @@ export function getByteSize(value: string): number { // .replace(/[\u{0800}-\u{D7FF}\u{E000}-\u{FFFF}]/u, '0') // 0000 - .replace(/[\u{D800}-\u{DFFF}]/u, "00").length + .replace(/[\uD800-\uDFFF]/u, "00").length ); } diff --git a/src/appsscript/sheet/appendColumns.ts b/src/appsscript/sheet/appendColumns.ts index 152d14a7..5c07d3b7 100644 --- a/src/appsscript/sheet/appendColumns.ts +++ b/src/appsscript/sheet/appendColumns.ts @@ -4,6 +4,26 @@ import { isConsistent2DArray, isNil } from "../../lang"; import { isRange } from "./isRange"; import { isSheet } from "./isSheet"; +/** + * Returns how many leading columns of the cells hold data: the position of + * the rightmost non-blank cell across all rows, or 0 when every cell is blank. + */ +function countFilledColumns(cells: unknown[][]): number { + let filled = 0; + + for (const row of cells) { + for (let column = row.length; column > filled; column--) { + if (!isBlank(row[column - 1])) { + filled = column; + + break; + } + } + } + + return filled; +} + /** * A cell counts as data unless it is empty: `0` and `false` are values a caller put there. */ @@ -106,19 +126,7 @@ export function appendColumns( let columnPosition: number; if (within) { - const cells = within.getValues(); - - let filled = 0; - - for (const row of cells) { - for (let column = row.length; column > filled; column--) { - if (!isBlank(row[column - 1])) { - filled = column; - - break; - } - } - } + const filled = countFilledColumns(within.getValues()); columnPosition = within.getColumn() + filled - 1; } else { diff --git a/src/appsscript/sheet/deleteColumnsByConditional.ts b/src/appsscript/sheet/deleteColumnsByConditional.ts index 7e1f1129..35c197d1 100644 --- a/src/appsscript/sheet/deleteColumnsByConditional.ts +++ b/src/appsscript/sheet/deleteColumnsByConditional.ts @@ -187,7 +187,9 @@ export function deleteColumnsByConditional( const selected: number[] = selectColumns(values, predicate, headerColumn, range.getColumn()); - if (!within && selected.length > 0 && selected.length === sheet.getMaxColumns()) { + const deletesFromWholeSheet = !within && selected.length > 0; + + if (deletesFromWholeSheet && selected.length === sheet.getMaxColumns()) { throw new IllegalArgumentException( "Refusing to delete every column: a sheet must keep at least one." ); diff --git a/src/appsscript/sheet/deleteRowsByConditional.ts b/src/appsscript/sheet/deleteRowsByConditional.ts index 0bea14dc..71545451 100644 --- a/src/appsscript/sheet/deleteRowsByConditional.ts +++ b/src/appsscript/sheet/deleteRowsByConditional.ts @@ -167,7 +167,9 @@ export function deleteRowsByConditional( const selected: number[] = selectRows(values, predicate, headerRow, range.getRow()); - if (!within && selected.length > 0 && selected.length === sheet.getMaxRows()) { + const deletesFromWholeSheet = !within && selected.length > 0; + + if (deletesFromWholeSheet && selected.length === sheet.getMaxRows()) { throw new IllegalArgumentException( "Refusing to delete every row: a sheet must keep at least one." ); diff --git a/src/appsscript/sheet/doGridRangesIntersect.ts b/src/appsscript/sheet/doGridRangesIntersect.ts index fd933126..78d1c8c6 100644 --- a/src/appsscript/sheet/doGridRangesIntersect.ts +++ b/src/appsscript/sheet/doGridRangesIntersect.ts @@ -52,14 +52,15 @@ export function doGridRangesIntersect(gridRange1: GridRange, gridRange2: GridRan : true; if (!sheetIdsMatch || !sheetNamesMatch) { - if ( - (isValidSheetId(gridRange1.sheetId) && - isValidSheetId(gridRange2.sheetId) && - !sheetIdsMatch) || - (isValidSheetName(gridRange1.sheetName) && - isValidSheetName(gridRange2.sheetName) && - !sheetNamesMatch) - ) { + const sheetIdsConflict = + isValidSheetId(gridRange1.sheetId) && isValidSheetId(gridRange2.sheetId) && !sheetIdsMatch; + + const sheetNamesConflict = + isValidSheetName(gridRange1.sheetName) && + isValidSheetName(gridRange2.sheetName) && + !sheetNamesMatch; + + if (sheetIdsConflict || sheetNamesConflict) { return false; } } diff --git a/src/appsscript/sheet/highlightHtml.ts b/src/appsscript/sheet/highlightHtml.ts index f29f00a1..4933810d 100644 --- a/src/appsscript/sheet/highlightHtml.ts +++ b/src/appsscript/sheet/highlightHtml.ts @@ -190,17 +190,20 @@ export function highlightHtml( const startIndex = match.index; - if (fullMatchText.startsWith("")) { + const isComment = fullMatchText.startsWith(""); + + const isTag = + fullMatchText.startsWith("<") || + fullMatchText.startsWith(""); + + if (isComment) { richTextBuilder.setTextStyle( startIndex, startIndex + fullMatchText.length, textStyles.comment ); - } else if ( - fullMatchText.startsWith("<") || - fullMatchText.startsWith("") - ) { + } else if (isTag) { richTextBuilder.setTextStyle( match.index, match.index + fullMatchText.length, diff --git a/src/appsscript/sheet/isCellGridRange.ts b/src/appsscript/sheet/isCellGridRange.ts index 4285acf7..7c8a772f 100644 --- a/src/appsscript/sheet/isCellGridRange.ts +++ b/src/appsscript/sheet/isCellGridRange.ts @@ -30,12 +30,13 @@ export function isCellGridRange(gridRange: GridRange): boolean { const { startRowIndex, endRowIndex, startColumnIndex, endColumnIndex } = gridRange; - if ( + const hasAllBounds = nonNil(startRowIndex) && nonNil(endRowIndex) && nonNil(startColumnIndex) && - nonNil(endColumnIndex) - ) { + nonNil(endColumnIndex); + + if (hasAllBounds) { const isSingleRow = endRowIndex - startRowIndex === 1; const isSingleColumn = endColumnIndex - startColumnIndex === 1; diff --git a/src/appsscript/sheet/isGridRangeContainedIn.ts b/src/appsscript/sheet/isGridRangeContainedIn.ts index 8c2e77a3..e4ca3c26 100644 --- a/src/appsscript/sheet/isGridRangeContainedIn.ts +++ b/src/appsscript/sheet/isGridRangeContainedIn.ts @@ -45,10 +45,13 @@ export function isGridRangeContainedIn( : true; if (!sheetIdsMatch || !sheetNamesMatch) { - if ( - (containerGridRange.sheetId != null && gridRange.sheetId != null && !sheetIdsMatch) || - (containerGridRange.sheetName != null && gridRange.sheetName != null && !sheetNamesMatch) - ) { + const sheetIdsConflict = + containerGridRange.sheetId != null && gridRange.sheetId != null && !sheetIdsMatch; + + const sheetNamesConflict = + containerGridRange.sheetName != null && gridRange.sheetName != null && !sheetNamesMatch; + + if (sheetIdsConflict || sheetNamesConflict) { return false; } } diff --git a/src/appsscript/sheet/isGridRangeSameDimensions.ts b/src/appsscript/sheet/isGridRangeSameDimensions.ts index fcae6a91..b5cebf8b 100644 --- a/src/appsscript/sheet/isGridRangeSameDimensions.ts +++ b/src/appsscript/sheet/isGridRangeSameDimensions.ts @@ -32,12 +32,13 @@ export function isGridRangeSameDimensions(range1: GridRange, range2: GridRange): const getDimensions = (gridRange: GridRange): { height: number; width: number } | null => { const { startRowIndex, endRowIndex, startColumnIndex, endColumnIndex } = gridRange; - if ( + const hasMissingBound = isNil(startRowIndex) || isNil(endRowIndex) || isNil(startColumnIndex) || - isNil(endColumnIndex) - ) { + isNil(endColumnIndex); + + if (hasMissingBound) { return null; } diff --git a/src/appsscript/sheet/isValidSheetName.ts b/src/appsscript/sheet/isValidSheetName.ts index daf77357..71d6763e 100644 --- a/src/appsscript/sheet/isValidSheetName.ts +++ b/src/appsscript/sheet/isValidSheetName.ts @@ -1,13 +1,19 @@ // SPDX-License-Identifier: Apache-2.0 import { isString } from "../../lang"; -/** Google Sheets rejects these characters anywhere in a sheet name. */ +/** + * Google Sheets rejects these characters anywhere in a sheet name. + */ const FORBIDDEN_CHARACTERS = /[\\/?*[\]]/; -/** Google Sheets caps a sheet name at 100 characters. */ +/** + * Google Sheets caps a sheet name at 100 characters. + */ const MAX_LENGTH = 100; -/** Google Sheets reserves this name, regardless of case. */ +/** + * Google Sheets reserves this name, regardless of case. + */ const RESERVED_NAME = "history"; /** diff --git a/src/appsscript/sheet/isValidSpreadsheetId.ts b/src/appsscript/sheet/isValidSpreadsheetId.ts index cfa264df..376451fd 100644 --- a/src/appsscript/sheet/isValidSpreadsheetId.ts +++ b/src/appsscript/sheet/isValidSpreadsheetId.ts @@ -1,7 +1,9 @@ // SPDX-License-Identifier: Apache-2.0 import { isString } from "../../lang"; -/** Drive file ids are at least 25 characters from an unreserved alphabet. */ +/** + * Drive file ids are at least 25 characters from an unreserved alphabet. + */ const PATTERN = /^[a-zA-Z0-9-_]{25,}$/; /** diff --git a/src/appsscript/sheet/parseA1Notation.ts b/src/appsscript/sheet/parseA1Notation.ts index 33dc2b1f..a3840d59 100644 --- a/src/appsscript/sheet/parseA1Notation.ts +++ b/src/appsscript/sheet/parseA1Notation.ts @@ -5,11 +5,13 @@ import { getColumnIndexByLetter } from "./getColumnIndexByLetter"; import { getColumnLetterByIndex } from "./getColumnLetterByIndex"; import type { GridRange } from "./types"; +// Optional parts are written as `(?:...|)` rather than `(...)?`: the same +// match, without a quantifier around a quantified group. const SHEET_AND_RANGE_REGEX = - /^(?:'(?[^']*(?:''[^']*)*)'|"(?[^"]*(?:""[^"]*)*)"|(?[A-Z][A-Z0-9_]*))!(?.*)$/i; + /^(?:'(?(?:[^']|'')*)'|"(?(?:[^"]|"")*)"|(?[A-Z][A-Z0-9_]*))!(?.*)$/i; const A1_RANGE_REGEX = - /^(?[A-Z]*)(?\d*)(?::(?[A-Z]*)(?\d*))?$/i; + /^(?[A-Z]*)(?\d*)(?::(?[A-Z]*)(?\d*)|)$/i; /** * Parses an A1 notation string into a GridRange object. @@ -84,13 +86,19 @@ export function parseA1Notation(a1Notation: string): GridRange { let eCol = endCol ? getColumnIndexByLetter(endCol) : null; if (hasColon) { + const hasBothCols = nonNull(sCol) && nonNull(eCol); + + const isOpenEnded = nonNull(sRow) && hasBothCols && isNull(eRow); + + const isOpenStarted = isNull(sRow) && hasBothCols && nonNull(eRow); + if (isNull(sRow) && isNull(eRow)) { sRow = 0; } else if (isNull(sCol) && isNull(eCol)) { sCol = 0; - } else if (nonNull(sRow) && nonNull(sCol) && nonNull(eCol) && isNull(eRow)) { + } else if (isOpenEnded) { // Keep eRow as null (unbounded) - } else if (isNull(sRow) && nonNull(sCol) && nonNull(eCol) && nonNull(eRow)) { + } else if (isOpenStarted) { sRow = 0; } } else { @@ -109,12 +117,16 @@ export function parseA1Notation(a1Notation: string): GridRange { } // Normalize: ensure start <= end if both are present - if (nonNull(sRow) && nonNull(eRow) && sRow > eRow) { - [sRow, eRow] = [eRow, sRow]; + if (nonNull(sRow) && nonNull(eRow)) { + if (sRow > eRow) { + [sRow, eRow] = [eRow, sRow]; + } } - if (nonNull(sCol) && nonNull(eCol) && sCol > eCol) { - [sCol, eCol] = [eCol, sCol]; + if (nonNull(sCol) && nonNull(eCol)) { + if (sCol > eCol) { + [sCol, eCol] = [eCol, sCol]; + } } const startRowIndex = sRow; @@ -205,79 +217,69 @@ function generateCanonicalA1(params: { const sRowNum = nonNull(startRowIndex) ? startRowIndex + 1 : ""; - // Single cell case - if ( - !hasColon && + const isSingleCell = nonNull(startColumnIndex) && nonNull(startRowIndex) && nonNull(endColumnIndex) && nonNull(endRowIndex) && startColumnIndex === endColumnIndex - 1 && - startRowIndex === endRowIndex - 1 - ) { - return `${sColLetter}${sRowNum}`; - } + startRowIndex === endRowIndex - 1; - // Single column case (B -> B:B) - if ( - !hasColon && + const isWholeColumns = nonNull(startColumnIndex) && nonNull(endColumnIndex) && startRowIndex === 0 && - isNull(endRowIndex) - ) { - return `${sColLetter}:${sColLetter}`; - } + isNull(endRowIndex); - // Single row case (5 -> 5:5) - if ( - !hasColon && + const isWholeRows = nonNull(startRowIndex) && nonNull(endRowIndex) && startColumnIndex === 0 && - isNull(endColumnIndex) - ) { + isNull(endColumnIndex); + + const hasStartCell = Boolean(startCol && startRow); + + const hasEndCell = Boolean(endCol && endRow); + + const hasColumnsOnly = Boolean(startCol && endCol && !startRow && !endRow); + + const hasRowsOnly = Boolean(startRow && endRow && !startCol && !endCol); + + const hasOpenEnd = Boolean(startCol && startRow && endCol && !endRow); + + const hasOpenStart = Boolean(startCol && endCol && endRow && !startRow); + + // Single cell case + if (!hasColon && isSingleCell) { + return `${sColLetter}${sRowNum}`; + } + + // Single column case (B -> B:B) + if (!hasColon && isWholeColumns) { + return `${sColLetter}:${sColLetter}`; + } + + // Single row case (5 -> 5:5) + if (!hasColon && isWholeRows) { return `${sRowNum}:${sRowNum}`; } // B2:B2 -> B2 - if ( - hasColon && - nonNull(startColumnIndex) && - nonNull(startRowIndex) && - nonNull(endColumnIndex) && - nonNull(endRowIndex) && - startColumnIndex === endColumnIndex - 1 && - startRowIndex === endRowIndex - 1 - ) { + if (hasColon && isSingleCell) { return `${sColLetter}${sRowNum}`; } // Column range (A:B) - if ( - hasColon && - nonNull(startColumnIndex) && - nonNull(endColumnIndex) && - startRowIndex === 0 && - isNull(endRowIndex) && - startCol && - endCol && - !startRow && - !endRow - ) { + const isColumnRange = isWholeColumns && hasColumnsOnly; + + if (hasColon && isColumnRange) { const eColLetter = getColumnLetterByIndex(endColumnIndex - 1); return `${sColLetter}:${eColLetter}`; } // Special GAS Cases for B:B if it was parsed from B - if ( - !hasColon && - nonNull(startColumnIndex) && - nonNull(endColumnIndex) && - startRowIndex === 0 && - isNull(endRowIndex) - ) { + if (!hasColon && isWholeColumns) { return `${sColLetter}:${sColLetter}`; } @@ -286,23 +288,23 @@ function generateCanonicalA1(params: { const eRowNum = nonNull(endRowIndex) ? endRowIndex : ""; - if (startCol && startRow && endCol && endRow) { + if (hasStartCell && hasEndCell) { return `${sColLetter}${sRowNum}:${eColLetter}${eRowNum}`; } - if (startCol && endCol && !startRow && !endRow) { + if (hasColumnsOnly) { return `${sColLetter}:${eColLetter}`; } - if (startRow && endRow && !startCol && !endCol) { + if (hasRowsOnly) { return `${sRowNum}:${eRowNum}`; } - if (startCol && startRow && endCol && !endRow) { + if (hasOpenEnd) { return `${sColLetter}${sRowNum}:${eColLetter}`; } - if (startCol && endCol && endRow && !startRow) { + if (hasOpenStart) { return `${sColLetter}:${eColLetter}${eRowNum}`; } } diff --git a/src/appsscript/sheet/prependColumns.ts b/src/appsscript/sheet/prependColumns.ts index f55a3865..3e7a829e 100644 --- a/src/appsscript/sheet/prependColumns.ts +++ b/src/appsscript/sheet/prependColumns.ts @@ -108,11 +108,9 @@ export function prependColumns( // Inserting at or before the boundary pushes it along with the data; // put it back when the caller asked to prepend before it. - if ( - !effectiveOptions.afterFrozenColumns && - frozenColumns > 0 && - columnPosition <= frozenColumns - ) { + const insertedInFrozen = frozenColumns > 0 && columnPosition <= frozenColumns; + + if (!effectiveOptions.afterFrozenColumns && insertedInFrozen) { sheet.setFrozenColumns(frozenColumns); } } diff --git a/src/appsscript/sheet/prependRows.ts b/src/appsscript/sheet/prependRows.ts index 186e5470..9ce51c73 100644 --- a/src/appsscript/sheet/prependRows.ts +++ b/src/appsscript/sheet/prependRows.ts @@ -107,11 +107,9 @@ export function prependRows( // Inserting at or above the boundary pushes it along with the data; // put it back when the caller asked to prepend before it. - if ( - effectiveOptions.afterFrozenRows === false && - frozenRows > 0 && - rowPosition <= frozenRows - ) { + const insertedInFrozen = frozenRows > 0 && rowPosition <= frozenRows; + + if (effectiveOptions.afterFrozenRows === false && insertedInFrozen) { sheet.setFrozenRows(frozenRows); } } diff --git a/src/appsscript/sheet/requireGridRangeContainedIn.ts b/src/appsscript/sheet/requireGridRangeContainedIn.ts index 8c1bb105..5d33a519 100644 --- a/src/appsscript/sheet/requireGridRangeContainedIn.ts +++ b/src/appsscript/sheet/requireGridRangeContainedIn.ts @@ -3,13 +3,23 @@ import { InvalidGridRangeException } from "../../exception"; import { isGridRangeContainedIn } from "./isGridRangeContainedIn"; import type { GridRange } from "./types"; -/** Renders a grid range as `rows a–b, columns c–d`, leaving open bounds as `…`. */ +/** + * Renders a grid range as `rows a–b, columns c–d`, leaving open bounds as `…`. + */ function describeBounds(gridRange: GridRange): string { const { startRowIndex, endRowIndex, startColumnIndex, endColumnIndex } = gridRange ?? {}; const bound = (value: number | null | undefined): string => (value == null ? "…" : `${value}`); - return `rows ${bound(startRowIndex)}–${bound(endRowIndex)}, columns ${bound(startColumnIndex)}–${bound(endColumnIndex)}`; + const startRow = bound(startRowIndex); + + const endRow = bound(endRowIndex); + + const startColumn = bound(startColumnIndex); + + const endColumn = bound(endColumnIndex); + + return `rows ${startRow}–${endRow}, columns ${startColumn}–${endColumn}`; } /** @@ -48,10 +58,11 @@ export function requireGridRangeContainedIn( message?: string ): GridRange { if (!isGridRangeContainedIn(gridRange, containerGridRange)) { - throw new InvalidGridRangeException( - message ?? - `Expected ${describeBounds(gridRange)} to lie within ${describeBounds(containerGridRange)}.` - ); + const inner = describeBounds(gridRange); + + const outer = describeBounds(containerGridRange); + + throw new InvalidGridRangeException(message ?? `Expected ${inner} to lie within ${outer}.`); } return gridRange; diff --git a/src/appsscript/sheet/requireGridRangeSameDimensions.ts b/src/appsscript/sheet/requireGridRangeSameDimensions.ts index ae41c4df..74bdf855 100644 --- a/src/appsscript/sheet/requireGridRangeSameDimensions.ts +++ b/src/appsscript/sheet/requireGridRangeSameDimensions.ts @@ -3,20 +3,27 @@ import { InvalidGridRangeException } from "../../exception"; import { isGridRangeSameDimensions } from "./isGridRangeSameDimensions"; import type { GridRange } from "./types"; -/** Renders a grid range as `rows × columns`, or `unknown` when a bound is missing. */ +/** + * Renders a grid range as `rows × columns`, or `unknown` when a bound is missing. + */ function describeShape(gridRange: GridRange): string { const { startRowIndex, endRowIndex, startColumnIndex, endColumnIndex } = gridRange ?? {}; - if ( + const hasMissingBound = startRowIndex == null || endRowIndex == null || startColumnIndex == null || - endColumnIndex == null - ) { + endColumnIndex == null; + + if (hasMissingBound) { return "unknown"; } - return `${endRowIndex - startRowIndex} × ${endColumnIndex - startColumnIndex}`; + const rows = endRowIndex - startRowIndex; + + const columns = endColumnIndex - startColumnIndex; + + return `${rows} × ${columns}`; } /** @@ -52,9 +59,12 @@ export function requireGridRangeSameDimensions( message?: string ): void { if (!isGridRangeSameDimensions(range1, range2)) { + const shape1 = describeShape(range1); + + const shape2 = describeShape(range2); + throw new InvalidGridRangeException( - message ?? - `Expected grid ranges of equal dimensions, but received ${describeShape(range1)} and ${describeShape(range2)}.` + message ?? `Expected grid ranges of equal dimensions, but received ${shape1} and ${shape2}.` ); } } diff --git a/src/appsscript/sheet/requireValidSpreadsheetId.ts b/src/appsscript/sheet/requireValidSpreadsheetId.ts index 164623e4..d294fda4 100644 --- a/src/appsscript/sheet/requireValidSpreadsheetId.ts +++ b/src/appsscript/sheet/requireValidSpreadsheetId.ts @@ -3,7 +3,9 @@ import { IllegalArgumentException } from "../../exception"; import { isString } from "../../lang"; import { isValidSpreadsheetId } from "./isValidSpreadsheetId"; -/** Recognises a value that is a Sheets URL rather than an id. */ +/** + * Recognises a value that is a Sheets URL rather than an id. + */ const SHEETS_URL = /docs\.google\.com\/spreadsheets/; /** diff --git a/src/appsscript/sheet/sortSheets.ts b/src/appsscript/sheet/sortSheets.ts index 0d5b4004..c03908bd 100644 --- a/src/appsscript/sheet/sortSheets.ts +++ b/src/appsscript/sheet/sortSheets.ts @@ -58,6 +58,8 @@ export function sortSheets( } }); } catch (err: unknown) { + // The error is swallowed; the Apps Script log is its only trace. + // eslint-disable-next-line no-console console.error(`Failed to sort sheets: ${err}`); } } diff --git a/src/appsscript/sheet/toA1Notation.ts b/src/appsscript/sheet/toA1Notation.ts index b0a4a075..388d31f2 100644 --- a/src/appsscript/sheet/toA1Notation.ts +++ b/src/appsscript/sheet/toA1Notation.ts @@ -75,16 +75,27 @@ export function toA1Notation(gridRange: GridRange): string { ? getColumnLetterByIndex((endColumnIndex as number) - 1) : ""; - if ( - hasStartCol && - hasStartRow && - hasEndCol && - hasEndRow && + const hasStartCell = hasStartCol && hasStartRow; + + const hasEndCell = hasEndCol && hasEndRow; + + const isSingleCell = + hasStartCell && + hasEndCell && (endColumnIndex as number) === (startColumnIndex as number) + 1 && - (endRowIndex as number) === (startRowIndex as number) + 1 - ) { + (endRowIndex as number) === (startRowIndex as number) + 1; + + const isFullColumns = hasStartCell && (startRowIndex as number) === 0 && !hasEndRow; + + const isFullRows = hasStartCell && (startColumnIndex as number) === 0 && !hasEndCol; + + const isOpenEnded = hasStartCell && hasEndCol && !hasEndRow; + + const isBounded = hasStartCell && hasEndCell; + + if (isSingleCell) { rangePart = `${a1StartColLetter}${a1StartRowNumber}`; - } else if (hasStartCol && hasStartRow && (startRowIndex as number) === 0 && !hasEndRow) { + } else if (isFullColumns) { if (hasEndCol && (endColumnIndex as number) > (startColumnIndex as number) + 1) { rangePart = `${a1StartColLetter}:${a1EndColLetter}`; } else if (hasEndCol && (endColumnIndex as number) === (startColumnIndex as number) + 1) { @@ -96,7 +107,7 @@ export function toA1Notation(gridRange: GridRange): string { `Invalid or incomplete GridRange object for full column A1 notation conversion.` ); } - } else if (hasStartRow && hasStartCol && (startColumnIndex as number) === 0 && !hasEndCol) { + } else if (isFullRows) { if (hasEndRow && (endRowIndex as number) > (startRowIndex as number) + 1) { rangePart = `${a1StartRowNumber}:${a1EndRowNumber}`; } else if (hasEndRow && (endRowIndex as number) === (startRowIndex as number) + 1) { @@ -108,9 +119,9 @@ export function toA1Notation(gridRange: GridRange): string { `Invalid or incomplete GridRange object for full row A1 notation conversion.` ); } - } else if (hasStartCol && hasStartRow && hasEndCol && !hasEndRow) { + } else if (isOpenEnded) { rangePart = `${a1StartColLetter}${a1StartRowNumber}:${a1EndColLetter}`; - } else if (hasStartCol && hasStartRow && hasEndCol && hasEndRow) { + } else if (isBounded) { rangePart = `${a1StartColLetter}${a1StartRowNumber}:${a1EndColLetter}${a1EndRowNumber}`; } else { throw new Error(`Invalid or incomplete GridRange object for A1 notation conversion.`); @@ -127,7 +138,9 @@ export function toA1Notation(gridRange: GridRange): string { } else if (!sheetName.includes('"')) { fullA1Notation += `"${sheetName}"!`; } else { - fullA1Notation += `'${sheetName.replace(/'/g, "''")}'!`; + const escapedSheetName = sheetName.replace(/'/g, "''"); + + fullA1Notation += `'${escapedSheetName}'!`; } } else { fullA1Notation += `${sheetName}!`; diff --git a/src/appsscript/sheet/updateFormulas.ts b/src/appsscript/sheet/updateFormulas.ts index dc476206..3e2acd8d 100644 --- a/src/appsscript/sheet/updateFormulas.ts +++ b/src/appsscript/sheet/updateFormulas.ts @@ -159,16 +159,14 @@ export function updateFormulas( const before: string[][] = range.getFormulas(); const cells: Cell[][] = before.map((row: string[], rowIndex: number): Cell[] => - row.map( - (formula: string, columnIndex: number): Cell => ({ - before: formula, - // An empty string is a cell holding a value, not a formula. Leave it. - after: - formula === "" - ? formula - : transform(formula, firstRow + rowIndex, firstColumn + columnIndex) - }) - ) + row.map((formula: string, columnIndex: number): Cell => ({ + before: formula, + // An empty string is a cell holding a value, not a formula. Leave it. + after: + formula === "" + ? formula + : transform(formula, firstRow + rowIndex, firstColumn + columnIndex) + })) ); let changed: number = 0; diff --git a/src/appsscript/sheet/updateSheetNameInA1Notation.ts b/src/appsscript/sheet/updateSheetNameInA1Notation.ts index aedb4402..56d4e5fc 100644 --- a/src/appsscript/sheet/updateSheetNameInA1Notation.ts +++ b/src/appsscript/sheet/updateSheetNameInA1Notation.ts @@ -56,5 +56,7 @@ export function updateSheetNameInA1Notation(a1Notation: string, sheetName?: stri return `"${sheetName}"!${range}`; } - return `'${sheetName.replace(/'/g, "''")}'!${range}`; + const escapedSheetName = sheetName.replace(/'/g, "''"); + + return `'${escapedSheetName}'!${range}`; } diff --git a/src/appsscript/slide/convertMarkdownToRichText.ts b/src/appsscript/slide/convertMarkdownToRichText.ts index dc5c95f2..7689ab21 100644 --- a/src/appsscript/slide/convertMarkdownToRichText.ts +++ b/src/appsscript/slide/convertMarkdownToRichText.ts @@ -84,9 +84,13 @@ export function convertMarkdownToRichText(text: string, theme: Theme = {}): Rich for (const rule of rules) { const match = rule.regex.exec(input); - if (match && (closestMatch === null || match.index < closestMatch.index)) { - closestMatch = match; - activeRule = rule; + if (match) { + const isCloser = closestMatch === null || match.index < closestMatch.index; + + if (isCloser) { + closestMatch = match; + activeRule = rule; + } } } diff --git a/src/html/encodeHtml.ts b/src/html/encodeHtml.ts index 2cd8dfad..3f8575da 100755 --- a/src/html/encodeHtml.ts +++ b/src/html/encodeHtml.ts @@ -23,10 +23,14 @@ export function encodeHtml(value: string): string { function (full, char, next) { if (char !== "&" || next !== "#") { if (/[\u00A0-\u9999<>&]/.test(next)) { - next = `&#${next.charCodeAt(0)};`; + const nextCode = next.charCodeAt(0); + + next = `&#${nextCode};`; } - return `&#${char.charCodeAt(0)};${next}`; + const charCode = char.charCodeAt(0); + + return `&#${charCode};${next}`; } return full; diff --git a/src/json/parseJson.ts b/src/json/parseJson.ts index eb204a73..7811add4 100644 --- a/src/json/parseJson.ts +++ b/src/json/parseJson.ts @@ -74,7 +74,7 @@ export function parseJson(value: string): object { token === "true" || token === "false" || token === "null" || - /^-?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(token) || + /^-?\d+(?:\.\d+|)(?:[eE][+-]?\d+|)$/.test(token) || quotedString.test(token); const tokens = []; @@ -111,21 +111,19 @@ export function parseJson(value: string): object { } if (char === '"' || char === "'") { - if (isString) { - if (char === quoteType) { - isString = false; - currentToken += '"'; - tokens.push(currentToken); - currentToken = ""; - } else { - // A double quote inside a single-quoted string has to be escaped - // once the string is re-quoted with double quotes. - currentToken += char === '"' ? '\\"' : char; - } - } else { + if (!isString) { isString = true; quoteType = char; currentToken += '"'; + } else if (char === quoteType) { + isString = false; + currentToken += '"'; + tokens.push(currentToken); + currentToken = ""; + } else { + // A double quote inside a single-quoted string has to be escaped + // once the string is re-quoted with double quotes. + currentToken += char === '"' ? '\\"' : char; } } else if (isString) { currentToken += char; @@ -157,36 +155,36 @@ export function parseJson(value: string): object { let expectingKey = false; for (let i = 0; i < tokens.length; i++) { - const token = tokens[i]; - - if (token === "{" || token === "[") { - correctedTokens.push(token); - expectingKey = token === "{"; - expectingValue = token === "["; - } else if (token === "}" || token === "]") { - correctedTokens.push(token); + const lexeme = tokens[i]; + + if (lexeme === "{" || lexeme === "[") { + correctedTokens.push(lexeme); + expectingKey = lexeme === "{"; + expectingValue = lexeme === "["; + } else if (lexeme === "}" || lexeme === "]") { + correctedTokens.push(lexeme); expectingValue = false; expectingKey = false; - } else if (token === ":") { - correctedTokens.push(token); + } else if (lexeme === ":") { + correctedTokens.push(lexeme); expectingValue = true; expectingKey = false; - } else if (token === ",") { - correctedTokens.push(token); + } else if (lexeme === ",") { + correctedTokens.push(lexeme); expectingKey = correctedTokens[correctedTokens.length - 2] === "}"; expectingValue = !expectingKey; - } else if (expectingKey && isValidKey(token)) { - correctedTokens.push(toKey(token)); + } else if (expectingKey && isValidKey(lexeme)) { + correctedTokens.push(toKey(lexeme)); expectingKey = false; - } else if (expectingValue && isValidValue(token)) { - correctedTokens.push(token); + } else if (expectingValue && isValidValue(lexeme)) { + correctedTokens.push(lexeme); expectingValue = false; - } else if (isValidKey(token)) { - correctedTokens.push(toKey(token)); - } else if (isValidValue(token)) { - correctedTokens.push(token); + } else if (isValidKey(lexeme)) { + correctedTokens.push(toKey(lexeme)); + } else if (isValidValue(lexeme)) { + correctedTokens.push(lexeme); } else { - throw new Error(`Invalid token: ${token}`); + throw new Error(`Invalid token: ${lexeme}`); } } diff --git a/src/json/stringifyJson.ts b/src/json/stringifyJson.ts index 345586b4..3261bd0f 100644 --- a/src/json/stringifyJson.ts +++ b/src/json/stringifyJson.ts @@ -24,7 +24,9 @@ export function stringifyJson(value: unknown): string { } if (Array.isArray(value)) { - return `[${value.map((element) => stringifyJson(element)).join(",")}]`; + const elements = value.map((element) => stringifyJson(element)).join(","); + + return `[${elements}]`; } const keys = Object.keys(value).sort(); @@ -37,5 +39,7 @@ export function stringifyJson(value: unknown): string { return `${stringifiedKey}:${stringifiedValue}`; }); - return `{${pairs.join(",")}}`; + const members = pairs.join(","); + + return `{${members}}`; } diff --git a/src/lang/base/index.ts b/src/lang/base/index.ts index 8efa1c1d..0cb4ace6 100644 --- a/src/lang/base/index.ts +++ b/src/lang/base/index.ts @@ -102,6 +102,7 @@ export * from "./requireRegExp"; export * from "./requireScalar"; export * from "./requireString"; + export * from "./requireSymbol"; export * from "./requireUndefined"; @@ -125,6 +126,7 @@ export * from "./requireNonNil"; export * from "./requireNonNull"; export * from "./requireState"; + export * from "./requireNonNumber"; export * from "./requireNonNumberLike"; diff --git a/src/lang/string/index.ts b/src/lang/string/index.ts index c8bf04ae..8da7865c 100644 --- a/src/lang/string/index.ts +++ b/src/lang/string/index.ts @@ -24,6 +24,7 @@ export * from "./requireNonEmptyString"; export * from "./nonEmptyString"; export * from "./requireValidEmail"; + export * from "./requireValidLocale"; export * from "./requireValidSlug"; diff --git a/src/lang/string/isEmail.ts b/src/lang/string/isEmail.ts index c0a39b0e..39ca7e6b 100644 --- a/src/lang/string/isEmail.ts +++ b/src/lang/string/isEmail.ts @@ -37,7 +37,7 @@ export function isEmail(email: unknown): email is string { return false; } - const USERNAME_PATTERN = /^[a-zA-Z0-9](?:[a-zA-Z0-9._-]*[a-zA-Z0-9])?$/; + const USERNAME_PATTERN = /^(?:[a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$/; const plusIndex = usernamePart.indexOf("+"); diff --git a/test/appsscript/admin/nonAdmin.test.ts b/test/appsscript/admin/nonAdmin.test.ts index 2e95ac7e..012086e7 100644 --- a/test/appsscript/admin/nonAdmin.test.ts +++ b/test/appsscript/admin/nonAdmin.test.ts @@ -3,7 +3,9 @@ import { afterEach, describe, expect, it, vi } from "vitest"; type Mutable = Record; -/** Installs stand-ins for the Apps Script globals `isAdmin` reaches for. */ +/** + * Installs stand-ins for the Apps Script globals `isAdmin` reaches for. + */ function mockDirectory(isAdminFlag: boolean | undefined, email = "user@example.com"): void { (globalThis as Mutable).Session = { getActiveUser: () => ({ getEmail: () => email }) diff --git a/test/appsscript/admin/requireAdmin.test.ts b/test/appsscript/admin/requireAdmin.test.ts index 17df70e5..cd262ffd 100644 --- a/test/appsscript/admin/requireAdmin.test.ts +++ b/test/appsscript/admin/requireAdmin.test.ts @@ -4,7 +4,9 @@ import { afterEach, describe, expect, it, vi } from "vitest"; type Mutable = Record; -/** Installs stand-ins for the Apps Script globals `isAdmin` reaches for. */ +/** + * Installs stand-ins for the Apps Script globals `isAdmin` reaches for. + */ function mockDirectory(isAdminFlag: boolean | undefined, email = "user@example.com"): void { (globalThis as Mutable).Session = { getActiveUser: () => ({ getEmail: () => email }) diff --git a/test/appsscript/sheet/getSchema.test.ts b/test/appsscript/sheet/getSchema.test.ts index d0d166e8..28947ec2 100644 --- a/test/appsscript/sheet/getSchema.test.ts +++ b/test/appsscript/sheet/getSchema.test.ts @@ -64,6 +64,7 @@ describe("getSchema", () => { it("should prefer the current key over the legacy key", () => { const legacy = { version: 1, headerRow: 1, columns: [{ name: "Legacy" }] }; + const current = { version: 1, headerRow: 1, columns: [{ name: "Current" }] }; const sheet = sheetMock( diff --git a/test/appsscript/sheet/isValidSpreadsheetId.test.ts b/test/appsscript/sheet/isValidSpreadsheetId.test.ts index 97a28447..04cb70e0 100644 --- a/test/appsscript/sheet/isValidSpreadsheetId.test.ts +++ b/test/appsscript/sheet/isValidSpreadsheetId.test.ts @@ -1,7 +1,9 @@ import { isValidSpreadsheetId } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** 44 characters, the usual shape of a Drive file id. */ +/** + * 44 characters, the usual shape of a Drive file id. + */ const validId = "1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789AbCdEfG"; describe("isValidSpreadsheetId", () => { diff --git a/test/appsscript/sheet/nonGridRangeContainedIn.test.ts b/test/appsscript/sheet/nonGridRangeContainedIn.test.ts index d2f93e78..dcbae320 100644 --- a/test/appsscript/sheet/nonGridRangeContainedIn.test.ts +++ b/test/appsscript/sheet/nonGridRangeContainedIn.test.ts @@ -2,6 +2,7 @@ import { nonGridRangeContainedIn } from "@/appsscript"; import { describe, expect, it } from "vitest"; const outer = { startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumnIndex: 5 }; + const inner = { startRowIndex: 2, endRowIndex: 4, startColumnIndex: 1, endColumnIndex: 3 }; describe("nonGridRangeContainedIn", () => { diff --git a/test/appsscript/sheet/nonRichTextValue.test.ts b/test/appsscript/sheet/nonRichTextValue.test.ts index 826e0230..06aa2b7a 100644 --- a/test/appsscript/sheet/nonRichTextValue.test.ts +++ b/test/appsscript/sheet/nonRichTextValue.test.ts @@ -1,7 +1,9 @@ import { nonRichTextValue } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** Apps Script service objects report their class name from `toString()`. */ +/** + * Apps Script service objects report their class name from `toString()`. + */ const richTextMock = { toString: (): string => "RichTextValue" }; describe("nonRichTextValue", () => { diff --git a/test/appsscript/sheet/nonSpreadsheet.test.ts b/test/appsscript/sheet/nonSpreadsheet.test.ts index dce9ff92..5e24047f 100644 --- a/test/appsscript/sheet/nonSpreadsheet.test.ts +++ b/test/appsscript/sheet/nonSpreadsheet.test.ts @@ -1,8 +1,11 @@ import { nonSpreadsheet } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** Apps Script service objects report their class name from `toString()`. */ +/** + * Apps Script service objects report their class name from `toString()`. + */ const spreadsheetMock = { toString: (): string => "Spreadsheet" }; + const sheetMock = { toString: (): string => "Sheet" }; describe("nonSpreadsheet", () => { diff --git a/test/appsscript/sheet/nonTextStyle.test.ts b/test/appsscript/sheet/nonTextStyle.test.ts index 16852920..676fe337 100644 --- a/test/appsscript/sheet/nonTextStyle.test.ts +++ b/test/appsscript/sheet/nonTextStyle.test.ts @@ -1,7 +1,9 @@ import { nonTextStyle } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** Apps Script service objects report their class name from `toString()`. */ +/** + * Apps Script service objects report their class name from `toString()`. + */ const textStyleMock = { toString: (): string => "TextStyle" }; describe("nonTextStyle", () => { diff --git a/test/appsscript/sheet/nonValidSpreadsheetId.test.ts b/test/appsscript/sheet/nonValidSpreadsheetId.test.ts index e4298b73..7045c251 100644 --- a/test/appsscript/sheet/nonValidSpreadsheetId.test.ts +++ b/test/appsscript/sheet/nonValidSpreadsheetId.test.ts @@ -1,7 +1,9 @@ import { nonValidSpreadsheetId } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** 44 characters, the usual shape of a Drive file id. */ +/** + * 44 characters, the usual shape of a Drive file id. + */ const validId = "1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789AbCdEfG"; describe("nonValidSpreadsheetId", () => { diff --git a/test/appsscript/sheet/prependColumn.test.ts b/test/appsscript/sheet/prependColumn.test.ts index 769ed455..a367b810 100644 --- a/test/appsscript/sheet/prependColumn.test.ts +++ b/test/appsscript/sheet/prependColumn.test.ts @@ -53,8 +53,7 @@ function rangeMock( sheet: GoogleAppsScript.Spreadsheet.Sheet, row: number, column: number, - numRows = 10, - numColumns = 4 + { numRows = 10, numColumns = 4 }: { numRows?: number; numColumns?: number } = {} ): GoogleAppsScript.Spreadsheet.Range { return { toString: () => "Range", diff --git a/test/appsscript/sheet/prependColumns.test.ts b/test/appsscript/sheet/prependColumns.test.ts index d6b7bd98..ced26a48 100644 --- a/test/appsscript/sheet/prependColumns.test.ts +++ b/test/appsscript/sheet/prependColumns.test.ts @@ -63,8 +63,7 @@ function rangeMock( sheet: GoogleAppsScript.Spreadsheet.Sheet, row: number, column: number, - numRows = 10, - numColumns = 4 + { numRows = 10, numColumns = 4 }: { numRows?: number; numColumns?: number } = {} ): GoogleAppsScript.Spreadsheet.Range { return { toString: () => "Range", diff --git a/test/appsscript/sheet/prependRow.test.ts b/test/appsscript/sheet/prependRow.test.ts index 9d904482..f4800bb7 100644 --- a/test/appsscript/sheet/prependRow.test.ts +++ b/test/appsscript/sheet/prependRow.test.ts @@ -56,8 +56,7 @@ function rangeMock( sheet: GoogleAppsScript.Spreadsheet.Sheet, row: number, column: number, - numRows = 10, - numColumns = 4 + { numRows = 10, numColumns = 4 }: { numRows?: number; numColumns?: number } = {} ): GoogleAppsScript.Spreadsheet.Range { return { toString: () => "Range", diff --git a/test/appsscript/sheet/prependRows.test.ts b/test/appsscript/sheet/prependRows.test.ts index bf93cbc2..a7e59c21 100644 --- a/test/appsscript/sheet/prependRows.test.ts +++ b/test/appsscript/sheet/prependRows.test.ts @@ -56,8 +56,7 @@ function rangeMock( sheet: GoogleAppsScript.Spreadsheet.Sheet, row: number, column: number, - numRows = 10, - numColumns = 4 + { numRows = 10, numColumns = 4 }: { numRows?: number; numColumns?: number } = {} ): GoogleAppsScript.Spreadsheet.Range { return { toString: () => "Range", diff --git a/test/appsscript/sheet/requireGridRangeContainedIn.test.ts b/test/appsscript/sheet/requireGridRangeContainedIn.test.ts index 8aa7b9a2..b04ebc45 100644 --- a/test/appsscript/sheet/requireGridRangeContainedIn.test.ts +++ b/test/appsscript/sheet/requireGridRangeContainedIn.test.ts @@ -3,6 +3,7 @@ import { InvalidGridRangeException } from "@/exception"; import { describe, expect, it } from "vitest"; const outer = { startRowIndex: 0, endRowIndex: 10, startColumnIndex: 0, endColumnIndex: 5 }; + const inner = { startRowIndex: 2, endRowIndex: 4, startColumnIndex: 1, endColumnIndex: 3 }; describe("requireGridRangeContainedIn", () => { diff --git a/test/appsscript/sheet/requireRichTextValue.test.ts b/test/appsscript/sheet/requireRichTextValue.test.ts index 74f8a569..1a9915b2 100644 --- a/test/appsscript/sheet/requireRichTextValue.test.ts +++ b/test/appsscript/sheet/requireRichTextValue.test.ts @@ -2,7 +2,9 @@ import { requireRichTextValue } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** Apps Script service objects report their class name from `toString()`. */ +/** + * Apps Script service objects report their class name from `toString()`. + */ const richTextMock = { toString: (): string => "RichTextValue" }; describe("requireRichTextValue", () => { diff --git a/test/appsscript/sheet/requireTextStyle.test.ts b/test/appsscript/sheet/requireTextStyle.test.ts index 008e3e34..dca5bedb 100644 --- a/test/appsscript/sheet/requireTextStyle.test.ts +++ b/test/appsscript/sheet/requireTextStyle.test.ts @@ -2,7 +2,9 @@ import { requireTextStyle } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** Apps Script service objects report their class name from `toString()`. */ +/** + * Apps Script service objects report their class name from `toString()`. + */ const textStyleMock = { toString: (): string => "TextStyle" }; describe("requireTextStyle", () => { diff --git a/test/appsscript/sheet/requireValidSpreadsheetId.test.ts b/test/appsscript/sheet/requireValidSpreadsheetId.test.ts index a51a7436..588bb4c7 100644 --- a/test/appsscript/sheet/requireValidSpreadsheetId.test.ts +++ b/test/appsscript/sheet/requireValidSpreadsheetId.test.ts @@ -2,7 +2,9 @@ import { requireValidSpreadsheetId } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** 44 characters, the usual shape of a Drive file id. */ +/** + * 44 characters, the usual shape of a Drive file id. + */ const validId = "1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789AbCdEfG"; describe("requireValidSpreadsheetId", () => { diff --git a/test/appsscript/slide/convertRichTextToMarkdown.test.ts b/test/appsscript/slide/convertRichTextToMarkdown.test.ts index 4d51eb08..30ff963b 100644 --- a/test/appsscript/slide/convertRichTextToMarkdown.test.ts +++ b/test/appsscript/slide/convertRichTextToMarkdown.test.ts @@ -110,7 +110,9 @@ describe("convertRichTextToMarkdown", () => { ]; for (const text of cases) { - it(`should return the original text for ${JSON.stringify(text)}`, () => { + const quoted = JSON.stringify(text); + + it(`should return the original text for ${quoted}`, () => { expect(convertRichTextToMarkdown(convertMarkdownToRichText(text))).toBe(text); }); } diff --git a/test/appsscript/slide/nonPresentation.test.ts b/test/appsscript/slide/nonPresentation.test.ts index 52c32aa2..64bbc006 100644 --- a/test/appsscript/slide/nonPresentation.test.ts +++ b/test/appsscript/slide/nonPresentation.test.ts @@ -1,13 +1,17 @@ import { nonPresentation } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the two methods `isPresentation` probes for. */ +/** + * A stand-in carrying the two methods `isPresentation` probes for. + */ const presentationMock = { getId: (): string => "1AbCdEfGhIjKlMnOpQrStUvWxYz", getSlides: (): unknown[] => [] }; -/** A `Slide` carries a different pair of methods. */ +/** + * A `Slide` carries a different pair of methods. + */ const slideMock = { getObjectId: (): string => "p1", getPageElementById: (): unknown => undefined diff --git a/test/appsscript/slide/nonSlide.test.ts b/test/appsscript/slide/nonSlide.test.ts index 3ce399a2..c0ff9849 100644 --- a/test/appsscript/slide/nonSlide.test.ts +++ b/test/appsscript/slide/nonSlide.test.ts @@ -1,13 +1,17 @@ import { nonSlide } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the two methods `isSlide` probes for. */ +/** + * A stand-in carrying the two methods `isSlide` probes for. + */ const slideMock = { getObjectId: (): string => "p1", getPageElementById: (): unknown => undefined }; -/** A `Presentation` carries a different pair of methods. */ +/** + * A `Presentation` carries a different pair of methods. + */ const presentationMock = { getId: (): string => "abc", getSlides: (): unknown[] => [] diff --git a/test/appsscript/slide/nonValidPresentationId.test.ts b/test/appsscript/slide/nonValidPresentationId.test.ts index 533b2e24..7d3f9b5d 100644 --- a/test/appsscript/slide/nonValidPresentationId.test.ts +++ b/test/appsscript/slide/nonValidPresentationId.test.ts @@ -1,7 +1,9 @@ import { nonValidPresentationId } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** 44 characters, the usual shape of a Drive file id. */ +/** + * 44 characters, the usual shape of a Drive file id. + */ const validId = "1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789AbCdEfG"; describe("nonValidPresentationId", () => { diff --git a/test/appsscript/slide/requirePresentation.test.ts b/test/appsscript/slide/requirePresentation.test.ts index 1e12942c..08394677 100644 --- a/test/appsscript/slide/requirePresentation.test.ts +++ b/test/appsscript/slide/requirePresentation.test.ts @@ -2,7 +2,9 @@ import { requirePresentation } from "@/appsscript"; import { InvalidPresentationException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the two methods `isPresentation` probes for. */ +/** + * A stand-in carrying the two methods `isPresentation` probes for. + */ const presentationMock = { getId: (): string => "1AbCdEfGhIjKlMnOpQrStUvWxYz", getSlides: (): unknown[] => [] diff --git a/test/appsscript/slide/requireValidPresentationId.test.ts b/test/appsscript/slide/requireValidPresentationId.test.ts index 408ca607..9ed97678 100644 --- a/test/appsscript/slide/requireValidPresentationId.test.ts +++ b/test/appsscript/slide/requireValidPresentationId.test.ts @@ -2,7 +2,9 @@ import { requireValidPresentationId } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** 44 characters, the usual shape of a Drive file id. */ +/** + * 44 characters, the usual shape of a Drive file id. + */ const validId = "1AbCdEfGhIjKlMnOpQrStUvWxYz0123456789AbCdEfG"; describe("requireValidPresentationId", () => { diff --git a/test/appsscript/ui/nonHtmlOutput.test.ts b/test/appsscript/ui/nonHtmlOutput.test.ts index 45a77639..e7cd9a95 100644 --- a/test/appsscript/ui/nonHtmlOutput.test.ts +++ b/test/appsscript/ui/nonHtmlOutput.test.ts @@ -1,7 +1,9 @@ import { nonHtmlOutput } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the three methods `isHtmlOutput` probes for. */ +/** + * A stand-in carrying the three methods `isHtmlOutput` probes for. + */ const htmlOutputMock = { getContent: (): string => "", setTitle: (): unknown => undefined, @@ -21,7 +23,9 @@ describe("nonHtmlOutput", () => { describe("Incorrect input data", () => { it("should return true when any probed method is missing", () => { - const { setTitle: _omitted, ...withoutSetTitle } = htmlOutputMock; + const withoutSetTitle: Partial = { ...htmlOutputMock }; + + delete withoutSetTitle.setTitle; expect(nonHtmlOutput(withoutSetTitle)).toBe(true); expect(nonHtmlOutput({ getContent: (): string => "" })).toBe(true); diff --git a/test/appsscript/ui/nonTextOutput.test.ts b/test/appsscript/ui/nonTextOutput.test.ts index 92420515..c9928fbb 100644 --- a/test/appsscript/ui/nonTextOutput.test.ts +++ b/test/appsscript/ui/nonTextOutput.test.ts @@ -1,7 +1,9 @@ import { nonTextOutput } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the two methods `isTextOutput` probes for. */ +/** + * A stand-in carrying the two methods `isTextOutput` probes for. + */ const textOutputMock = { getMimeType: (): unknown => undefined, getContent: (): string => "" diff --git a/test/appsscript/ui/nonUi.test.ts b/test/appsscript/ui/nonUi.test.ts index 80603fa2..7d562f7f 100644 --- a/test/appsscript/ui/nonUi.test.ts +++ b/test/appsscript/ui/nonUi.test.ts @@ -1,7 +1,9 @@ import { nonUi } from "@/appsscript"; import { describe, expect, it } from "vitest"; -/** `isUi` identifies its target by the string an Apps Script `Ui` reports. */ +/** + * `isUi` identifies its target by the string an Apps Script `Ui` reports. + */ const uiMock = { toString: (): string => "Ui" }; diff --git a/test/appsscript/ui/requireHtmlOutput.test.ts b/test/appsscript/ui/requireHtmlOutput.test.ts index be4c3cd5..8ba063ea 100644 --- a/test/appsscript/ui/requireHtmlOutput.test.ts +++ b/test/appsscript/ui/requireHtmlOutput.test.ts @@ -2,7 +2,9 @@ import { requireHtmlOutput } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the three methods `isHtmlOutput` probes for. */ +/** + * A stand-in carrying the three methods `isHtmlOutput` probes for. + */ const htmlOutputMock = { getContent: (): string => "", setTitle: (): unknown => undefined, diff --git a/test/appsscript/ui/requireTextOutput.test.ts b/test/appsscript/ui/requireTextOutput.test.ts index ef157e9f..ba5ef135 100644 --- a/test/appsscript/ui/requireTextOutput.test.ts +++ b/test/appsscript/ui/requireTextOutput.test.ts @@ -2,7 +2,9 @@ import { requireTextOutput } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** A stand-in carrying the two methods `isTextOutput` probes for. */ +/** + * A stand-in carrying the two methods `isTextOutput` probes for. + */ const textOutputMock = { getMimeType: (): unknown => undefined, getContent: (): string => "" diff --git a/test/appsscript/ui/requireUi.test.ts b/test/appsscript/ui/requireUi.test.ts index a0572f3c..962bfb02 100644 --- a/test/appsscript/ui/requireUi.test.ts +++ b/test/appsscript/ui/requireUi.test.ts @@ -2,7 +2,9 @@ import { requireUi } from "@/appsscript"; import { IllegalArgumentException } from "@/exception"; import { describe, expect, it } from "vitest"; -/** `isUi` identifies its target by the string an Apps Script `Ui` reports. */ +/** + * `isUi` identifies its target by the string an Apps Script `Ui` reports. + */ const uiMock = { toString: (): string => "Ui" }; diff --git a/test/lang/base/isScalar.test.ts b/test/lang/base/isScalar.test.ts index fbf7e489..7d8be0a0 100644 --- a/test/lang/base/isScalar.test.ts +++ b/test/lang/base/isScalar.test.ts @@ -45,9 +45,7 @@ describe("isScalar", () => { }); it("should return false for boxed primitives", () => { - // eslint-disable-next-line no-new-wrappers expect(isScalar(new String("abc"))).toBe(false); - // eslint-disable-next-line no-new-wrappers expect(isScalar(new Number(1))).toBe(false); }); }); diff --git a/test/lang/base/requireFunctionLike.test.ts b/test/lang/base/requireFunctionLike.test.ts index e0b514fe..547dc061 100644 --- a/test/lang/base/requireFunctionLike.test.ts +++ b/test/lang/base/requireFunctionLike.test.ts @@ -5,7 +5,7 @@ import { describe, expect, it } from "vitest"; describe("requireFunctionLike", () => { describe("Correct input data", () => { it("should return the same function reference", () => { - const input = () => 1; + const input = (): number => 1; expect(requireFunctionLike(input)).toBe(input); }); diff --git a/test/lang/base/requireNonBoolean.test.ts b/test/lang/base/requireNonBoolean.test.ts index bea93d36..8cd4134b 100644 --- a/test/lang/base/requireNonBoolean.test.ts +++ b/test/lang/base/requireNonBoolean.test.ts @@ -17,7 +17,6 @@ describe("requireNonBoolean", () => { }); it("should accept a boxed Boolean object", () => { - // eslint-disable-next-line no-new-wrappers const boxed = new Boolean(true); expect(requireNonBoolean(boxed)).toBe(boxed); diff --git a/test/lang/base/requireNonObject.test.ts b/test/lang/base/requireNonObject.test.ts index 7f54ad44..d5766274 100644 --- a/test/lang/base/requireNonObject.test.ts +++ b/test/lang/base/requireNonObject.test.ts @@ -17,7 +17,7 @@ describe("requireNonObject", () => { }); it("should accept functions", () => { - const fn = () => 1; + const fn = (): number => 1; expect(requireNonObject(fn)).toBe(fn); expect(requireNonObject(class Sample {})).toBeTypeOf("function"); diff --git a/test/lang/base/requireNonScalar.test.ts b/test/lang/base/requireNonScalar.test.ts index 63e1df09..f55b4da1 100644 --- a/test/lang/base/requireNonScalar.test.ts +++ b/test/lang/base/requireNonScalar.test.ts @@ -22,7 +22,7 @@ describe("requireNonScalar", () => { }); it("should accept functions", () => { - const fn = () => 1; + const fn = (): number => 1; expect(requireNonScalar(fn)).toBe(fn); }); diff --git a/test/lang/base/requireNonString.test.ts b/test/lang/base/requireNonString.test.ts index bb96e635..94fff3ab 100644 --- a/test/lang/base/requireNonString.test.ts +++ b/test/lang/base/requireNonString.test.ts @@ -22,7 +22,6 @@ describe("requireNonString", () => { }); it("should accept a boxed String object", () => { - // eslint-disable-next-line no-new-wrappers const boxed = new String("abc"); expect(requireNonString(boxed)).toBe(boxed); diff --git a/test/scripts/merge-module-index.test.ts b/test/scripts/merge-module-index.test.ts index b69a7112..ab286145 100644 --- a/test/scripts/merge-module-index.test.ts +++ b/test/scripts/merge-module-index.test.ts @@ -63,7 +63,11 @@ afterEach(() => { } }); -describe("merge-module-index", () => { +/** + * Each case runs real git merges in a temporary repository; under parallel load they can take + * longer than Vitest's 5 s default. + */ +describe("merge-module-index", { timeout: 30_000 }, () => { describe("Placeholders that carry a signature", () => { it("should merge two sides each flipping a different one", () => { const { status, text } = merge( diff --git a/test/scripts/merge-reference-tables.test.ts b/test/scripts/merge-reference-tables.test.ts index 3d9149af..2eedf6ea 100644 --- a/test/scripts/merge-reference-tables.test.ts +++ b/test/scripts/merge-reference-tables.test.ts @@ -111,7 +111,11 @@ const DINGO = row("dingo"); const ZEBRA = row("zebra"); -describe("merge-reference-tables", () => { +/** + * Each case runs real git merges in a temporary repository; under parallel load they can take + * longer than Vitest's 5 s default. + */ +describe("merge-reference-tables", { timeout: 30_000 }, () => { describe("A table one side adds", () => { const base = section("Alpha", [AARDVARK]) + "\n" + section("Beta");