@devlander/utils

<!DOCTYPE html><html class="default" lang="en"><head><meta charSet="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>@devlander/utils – Cross-Platform JavaScript Utility Functions - v1.0.8</title><meta name="description" content="Documentation for @devlander/utils – Cross-Platform JavaScript Utility Functions"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="assets/style.css"/><link rel="stylesheet" href="assets/highlight.css"/><script defer src="assets/main.js"></script><script async src="assets/search.js" id="tsd-search-script"></script><script async src="assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os"</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><div class="table-cell" id="tsd-search" data-base="."><div class="field"><label for="tsd-search-field" class="tsd-widget tsd-toolbar-icon search no-caption"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-search"></use></svg></label><input type="text" id="tsd-search-field" aria-label="Search"/></div><div class="field"><div id="tsd-toolbar-links"></div></div><ul class="results"><li class="state loading">Preparing search index...</li><li class="state failure">The search index is not available</li></ul><a href="index.html" class="title">@devlander/utils – Cross-Platform JavaScript Utility Functions - v1.0.8</a></div><div class="table-cell" id="tsd-widgets"><a href="#" class="tsd-widget tsd-toolbar-icon menu no-caption" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><h2>@devlander/utils – Cross-Platform JavaScript Utility Functions - v1.0.8</h2></div><div class="tsd-panel tsd-typography"><a id="md:devlander-javascript-utilities-collection" class="tsd-anchor"></a><h1><a href="#md:devlander-javascript-utilities-collection">Devlander JavaScript Utilities Collection</a></h1><br/> <img src="https://github.com/Devlander-Software/utils/raw/main/media/images/javascript-utils-devlander-github-header-photo.png" alt="Devlander Utils Header"> <br/> <a href="https://bit.ly/devlander-discord-invite"> <img src="https://img.shields.io/badge/Discord-Devlander-%235865F2" alt="Join Devlander on Discord"> </a> <br/> <a href="https://www.npmjs.com/package/@devlander/utils"> <img src="https://img.shields.io/npm/dm/@devlander/utils.svg" alt="npm downloads"> </a> <br/> <a href="https://github.com/orgs/Devlander-Software/discussions"> <img src="https://img.shields.io/badge/Github%20Discussions%20%26%20Support-Chat%20now!-blue" alt="Join the discussion on Github"> </a> <br/> <a href="https://bit.ly/devlander-twitch"> <img src="https://img.shields.io/twitch/status/devlander" alt="Join Devlander on Twitch"> </a> <br/> <a href="https://bit.ly/landonwjohnson-on-twitter"> <img src="https://img.shields.io/twitter/follow/landonwjohnson.svg?style=social&label=Follow" alt="Follow Landon Johnson On Twitter"> </a> <br/> <a href="https://bit.ly/landonwjohnson-on-twitter"> <img src="https://wakatime.com/badge/user/bd50b6c5-e0ca-4937-83b3-ab2d13adbc73/project/018d49ad-1c41-4ee7-9a6b-5387db501fcb.svg" alt="Wakatime stats for utils"> </a> <p><img src="https://api.netlify.com/api/v1/badges/60806e06-d614-4a90-8a77-a39f065d65c2/deploy-status" alt="Netlify Status"></p> <br/> <p><img src="https://img.shields.io/badge/tests-298%20passed-brightgreen" alt="Tests"> <img src="https://img.shields.io/badge/coverage-87.37%25-brightgreen" alt="Coverage"> <img src="https://img.shields.io/badge/test%20suites-51%20passed-brightgreen" alt="Test Suites"> <img src="https://img.shields.io/badge/platforms-4%20supported-blue" alt="Platforms"></p> <br/> <a href="https://github.com/Devlander-Software/utils/coverage/index.html"> 📊 View Detailed Coverage Report </a> <br/> <p>Enhance your JavaScript projects with the Devlander JavaScript Utils Collection—a meticulously curated set of utility functions to streamline your coding workflow. Join our vibrant community on Discord, engage in discussions on GitHub, and stay updated with our latest streams on Twitch. Boost your project's efficiency today!</p> <a id="md:📈-package-statistics" class="tsd-anchor"></a><h3><a href="#md:📈-package-statistics">📈 Package Statistics</a></h3><ul> <li><strong>📦 61+ Published Versions</strong> - Continuously maintained and updated</li> <li><strong>🔧 100+ Utility Functions</strong> - Comprehensive utility library</li> <li><strong>📚 15+ Categories</strong> - Organized by functionality</li> <li><strong>🌐 4 Platform Support</strong> - React, Next.js, React Native, Node.js</li> <li><strong>⚡ Zero Dependencies</strong> - Lightweight and fast</li> <li><strong>🛡️ 87.37% Test Coverage</strong> - High reliability and quality</li> </ul> <hr> <a id="md:📚-new-to-contributing-start-here" class="tsd-anchor"></a><h2><a href="#md:📚-new-to-contributing-start-here">📚 New to contributing? Start here!</a></h2><p>If you're new to open source, npm packages, or TypeScript, <strong>please reference the step-by-step Medium articles linked below</strong>. These guides will walk you through everything from Git basics to advanced package publishing, testing, and code style:</p> <ul> <li><a href="https://medium.com/@techwithlandon/what-is-git-a-complete-beginners-guide-to-version-control-and-github-3327797528a5">What is Git? A Complete Beginner's Guide to Version Control and GitHub</a></li> <li><a href="https://medium.com/devlander/npm-packages-what-they-are-where-they-came-from-and-when-to-use-them-7304c411c1c5">npm Packages: What They Are, Where They Came From, and When to Use Them</a></li> <li><a href="https://medium.com/devlander/how-to-plan-and-structure-your-npm-package-for-success-956991cb6768">How to Plan and Structure Your npm Package for Success</a></li> <li><a href="https://medium.com/@techwithlandon/how-to-build-your-first-npm-package-validators-ad7d72d303d2">How to Build Your First npm Package: Validators</a></li> <li><a href="https://medium.com/devlander/how-to-add-typescript-to-your-npm-package-272d013809b9">How to Add TypeScript to Your npm Package</a></li> <li><a href="https://medium.com/@techwithlandon/testing-and-deploying-your-npm-package-with-jest-and-unit-testing-ca4acc0af641">Testing and Deploying Your npm Package with Jest and Unit Testing</a></li> <li><a href="https://medium.com/@techwithlandon/setting-up-eslint-and-prettier-for-your-npm-package-9e5e549f7b3e">Setting Up ESLint and Prettier for Your npm Package</a></li> </ul> <p><strong>These articles are highly recommended for all contributors!</strong></p> <hr> <a id="md:about-this-project" class="tsd-anchor"></a><h2><a href="#md:about-this-project">About This Project</a></h2><p>The Devlander JavaScript Utils Collection is an evolving library of JavaScript utilities developed by Landon Johnson. These utilities address everyday coding tasks, reducing the need for repetitive code and enhancing productivity. Open to community input for naming and improvements, this project aims to be a go-to resource for developers.</p> <a id="md:utilities-overview" class="tsd-anchor"></a><h2><a href="#md:utilities-overview">Utilities Overview</a></h2><a id="md:json-utilities" class="tsd-anchor"></a><h3><a href="#md:json-utilities">JSON Utilities</a></h3><ul> <li><strong><code>isDeepEqual(obj1, obj2)</code></strong>: Deeply compares two objects for equality.</li> <li><strong><code>isJson(value)</code></strong>: Validates if a value is a legitimate JSON string or object.</li> <li><strong><code>mergeObjects(oldObj, newObj)</code></strong>: Merges two nested objects into one.</li> </ul> <a id="md:filter-utilities" class="tsd-anchor"></a><h3><a href="#md:filter-utilities">Filter Utilities</a></h3><ul> <li><strong><code>hasItemByLetterAndFilter(array, key, value)</code></strong>: Filters various objects based on a specified letter and additional filter criteria.</li> </ul> <a id="md:conversion-utilities" class="tsd-anchor"></a><h3><a href="#md:conversion-utilities">Conversion Utilities</a></h3><ul> <li><strong><code>abbreviateNumber(value)</code></strong>: Abbreviates numbers with appropriate suffixes (k, m, b, t) for readability.</li> </ul> <a id="md:timeout-utilities" class="tsd-anchor"></a><h3><a href="#md:timeout-utilities">Timeout Utilities</a></h3><ul> <li><strong><code>waitFor(value, timeUnits?: ms | s, logDuration?: boolean)</code></strong>: Delays the execution of a function by a specified time.</li> </ul> <a id="md:quick-start-and-documentation" class="tsd-anchor"></a><h2><a href="#md:quick-start-and-documentation">Quick Start and Documentation</a></h2><p>Dive into our utility functions with ease. Each utility is documented with parameters, return values, and usage examples to get you started quickly. Whether you're merging objects, checking JSON validity, or filtering data, our collection is designed to enhance your development process with minimal effort.</p> <ul> <li><strong>Installation</strong>: <code>npm install @devlander/utils</code></li> <li><strong>Usage</strong>: Import utilities as needed in your project. Example usage is provided for each function to illustrate its application.</li> </ul> <a id="md:changelog" class="tsd-anchor"></a><h2><a href="#md:changelog">Changelog</a></h2><p>For a full list of changes, check the <a href="./CHANGELOG.md">CHANGELOG.md</a> file.</p> <a id="md:engage-and-contribute" class="tsd-anchor"></a><h2><a href="#md:engage-and-contribute">Engage and Contribute</a></h2><p>We welcome contributions, feedback, and suggestions! Join our discussions on GitHub, or connect with us on Discord and Twitter. Your input helps us improve the Devlander JavaScript Utils Collection for the developer community.</p> <p><strong>Before contributing, please read the Medium articles above for step-by-step guidance on Git, npm, TypeScript, testing, and code style.</strong></p> <a id="md:become-a-sponsor" class="tsd-anchor"></a><h3><a href="#md:become-a-sponsor"><a href="https://bit.ly/sponsor-landonjohnson-github/">Become a Sponsor!</a></a></h3><a id="md:🧪-cross-platform-testing" class="tsd-anchor"></a><h2><a href="#md:🧪-cross-platform-testing">🧪 Cross-Platform Testing</a></h2><p>This package includes comprehensive cross-platform testing to ensure compatibility across different environments:</p> <a id="md:automated-testing" class="tsd-anchor"></a><h3><a href="#md:automated-testing">Automated Testing</a></h3><ul> <li><strong>Unit Tests</strong>: Run with <code>yarn test</code></li> <li><strong>Cross-Platform Tests</strong>: Run with <code>yarn test:examples</code></li> <li><strong>Full Pre-Publish Check</strong>: Run with <code>yarn prepublishOnly</code></li> </ul> <a id="md:example-apps" class="tsd-anchor"></a><h3><a href="#md:example-apps">Example Apps</a></h3><p>The <code>/examples</code> directory contains minimal test apps for each platform:</p> <ul> <li><strong>React</strong> (<code>examples/react/</code>) - Vite-based React app</li> <li><strong>Next.js</strong> (<code>examples/nextjs/</code>) - Next.js app with TypeScript</li> <li><strong>React Native</strong> (<code>examples/react-native/</code>) - Expo app</li> <li><strong>Node.js</strong> (<code>examples/node/</code>) - Node.js with TypeScript</li> </ul> <a id="md:how-it-works" class="tsd-anchor"></a><h3><a href="#md:how-it-works">How It Works</a></h3><ol> <li><strong>Build & Pack</strong>: Creates a tarball (exactly like npm would deliver)</li> <li><strong>Install</strong>: Installs the tarball into each example app</li> <li><strong>Test</strong>: Runs tests in each environment to verify imports work</li> <li><strong>Validate</strong>: Ensures your package works in real-world scenarios</li> </ol> <p>This guarantees that your package can be installed and used successfully in React, Next.js, React Native, and Node.js projects.</p> <a id="md:🏆-quality-assurance" class="tsd-anchor"></a><h2><a href="#md:🏆-quality-assurance">🏆 Quality Assurance</a></h2><a id="md:test-statistics" class="tsd-anchor"></a><h3><a href="#md:test-statistics">Test Statistics</a></h3><ul> <li><strong>✅ 298 Tests Passed</strong> - Comprehensive test coverage across all utilities</li> <li><strong>✅ 51 Test Suites</strong> - Organized testing for each utility category</li> <li><strong>✅ 87.37% Code Coverage</strong> - High coverage ensures reliability</li> <li><strong>✅ 4 Platforms Supported</strong> - Cross-platform compatibility verified</li> <li><strong>✅ 0 Failing Tests</strong> - All tests pass consistently</li> </ul> <a id="md:quality-metrics" class="tsd-anchor"></a><h3><a href="#md:quality-metrics">Quality Metrics</a></h3><ul> <li><strong>TypeScript Strict Mode</strong> - Full type safety with strict configuration</li> <li><strong>ESLint + Prettier</strong> - Consistent code style and quality</li> <li><strong>Jest Testing Framework</strong> - Industry-standard testing</li> <li><strong>Conventional Commits</strong> - Automated changelog generation</li> <li><strong>GitHub Actions CI/CD</strong> - Automated testing and deployment</li> <li><strong>Cross-Platform Validation</strong> - Works in React, Next.js, React Native, Node.js</li> </ul> <a id="md:reliability-features" class="tsd-anchor"></a><h3><a href="#md:reliability-features">Reliability Features</a></h3><ul> <li><strong>Zero Dependencies</strong> - Lightweight and fast</li> <li><strong>Tree Shaking Support</strong> - Only import what you use</li> <li><strong>Multiple Build Formats</strong> - CJS, ESM, and UMD support</li> <li><strong>TypeScript Definitions</strong> - Full type support included</li> <li><strong>Comprehensive Documentation</strong> - Auto-generated with TypeDoc</li> </ul> <a id="md:🚀-release-process" class="tsd-anchor"></a><h2><a href="#md:🚀-release-process">🚀 Release Process</a></h2><p>This project uses an automated release process with GitHub Actions. Here's how it works:</p> <a id="md:automatic-release-workflow" class="tsd-anchor"></a><h3><a href="#md:automatic-release-workflow">Automatic Release Workflow</a></h3><ol> <li><p><strong>Create a new version</strong>: Use one of the release commands:</p> <pre><code class="language-bash"><span class="hl-0"># Standard release (with version checking)</span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release:patch:check</span><span class="hl-2"> </span><span class="hl-0"># 1.0.1 → 1.0.2</span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release:minor:check</span><span class="hl-2"> </span><span class="hl-0"># 1.0.1 → 1.1.0 </span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release:major:check</span><span class="hl-2"> </span><span class="hl-0"># 1.0.1 → 2.0.0</span><br/><br/><span class="hl-0"># Quick release (no version checking)</span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release:patch</span><span class="hl-2"> </span><span class="hl-0"># 1.0.1 → 1.0.2</span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release:minor</span><span class="hl-2"> </span><span class="hl-0"># 1.0.1 → 1.1.0</span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release:major</span><span class="hl-2"> </span><span class="hl-0"># 1.0.1 → 2.0.0</span> </code><button>Copy</button></pre> </li> <li><p><strong>What happens automatically</strong>:</p> <ul> <li>✅ Version is incremented in <code>package.json</code></li> <li>✅ <strong>Version check</strong>: Verifies the version doesn't already exist on npm</li> <li>✅ Git tag is created and pushed</li> <li>✅ GitHub Action triggers on tag push</li> <li>✅ <strong>Smart publishing</strong>: Only publishes if version is new</li> <li>✅ Changelog is generated from conventional commits</li> <li>✅ Package is published to npm (if new version)</li> <li>✅ GitHub release is created with changelog notes</li> </ul> </li> </ol> <a id="md:manual-release-alternative" class="tsd-anchor"></a><h3><a href="#md:manual-release-alternative">Manual Release (Alternative)</a></h3><p>If you prefer manual control:</p> <pre><code class="language-bash"><span class="hl-0"># Generate changelog and create release</span><br/><span class="hl-1">yarn</span><span class="hl-2"> </span><span class="hl-3">release</span> </code><button>Copy</button></pre> <a id="md:commit-convention" class="tsd-anchor"></a><h3><a href="#md:commit-convention">Commit Convention</a></h3><p>This project uses <a href="https://www.conventionalcommits.org/">Conventional Commits</a> for automatic changelog generation:</p> <ul> <li><code>feat:</code> - New features</li> <li><code>fix:</code> - Bug fixes </li> <li><code>docs:</code> - Documentation changes</li> <li><code>style:</code> - Code style changes</li> <li><code>refactor:</code> - Code refactoring</li> <li><code>test:</code> - Test changes</li> <li><code>chore:</code> - Maintenance tasks</li> </ul> <a id="md:how-version-detection-works" class="tsd-anchor"></a><h3><a href="#md:how-version-detection-works">How Version Detection Works</a></h3><p>The release process uses <strong>dual-layer version checking</strong>:</p> <ol> <li><p><strong>Local Check</strong> (before pushing tag):</p> <pre><code class="language-bash"><span class="hl-1">npm</span><span class="hl-2"> </span><span class="hl-3">view</span><span class="hl-2"> </span><span class="hl-3">@devlander/utils@1.0.2</span><span class="hl-2"> </span><span class="hl-3">version</span> </code><button>Copy</button></pre> <ul> <li>If version exists → Stops and shows warning</li> <li>If version is new → Proceeds with tag push</li> </ul> </li> <li><p><strong>GitHub Action Check</strong> (after tag push):</p> <ul> <li>Extracts version from git tag (<code>v1.0.2</code> → <code>1.0.2</code>)</li> <li>Checks npm registry for existing version</li> <li>Only publishes if version is new</li> <li>Creates GitHub release regardless</li> </ul> </li> </ol> <a id="md:current-status" class="tsd-anchor"></a><h3><a href="#md:current-status">Current Status</a></h3><ul> <li><strong>Latest npm version</strong>: <code>1.0.0</code> (published 3 days ago)</li> <li><strong>Current package version</strong>: <code>1.0.1</code> (ready for next release)</li> <li><strong>GitHub Actions</strong>: ✅ Configured and working</li> <li><strong>Auto-release</strong>: ✅ Enabled with changelog generation</li> <li><strong>Version checking</strong>: ✅ Smart publishing (only new versions)</li> </ul> </div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-index-accordion"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="#icon-chevronDown"></use></svg>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><h4 class="uppercase">Member Visibility</h4><form><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></form></div><div class="tsd-theme-toggle"><h4 class="uppercase">Theme</h4><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-index-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="#icon-chevronDown"></use></svg>On This Page</h3></summary><div class="tsd-accordion-details"><ul><li><ul><li><a href="#md:devlander-javascript-utilities-collection"><span>Devlander <wbr/>Java<wbr/>Script <wbr/>Utilities <wbr/>Collection</span></a></li><li><ul><li><a href="#md:📈-package-statistics"><span>📈 <wbr/>Package <wbr/>Statistics</span></a></li><li><a href="#md:📚-new-to-contributing-start-here"><span>📚 <wbr/>New to contributing? <wbr/>Start here!</span></a></li><li><a href="#md:about-this-project"><span>About <wbr/>This <wbr/>Project</span></a></li><li><a href="#md:utilities-overview"><span>Utilities <wbr/>Overview</span></a></li><li><ul><li><a href="#md:json-utilities"><span>JSON <wbr/>Utilities</span></a></li><li><a href="#md:filter-utilities"><span>Filter <wbr/>Utilities</span></a></li><li><a href="#md:conversion-utilities"><span>Conversion <wbr/>Utilities</span></a></li><li><a href="#md:timeout-utilities"><span>Timeout <wbr/>Utilities</span></a></li></ul></li><li><a href="#md:quick-start-and-documentation"><span>Quick <wbr/>Start and <wbr/>Documentation</span></a></li><li><a href="#md:changelog"><span>Changelog</span></a></li><li><a href="#md:engage-and-contribute"><span>Engage and <wbr/>Contribute</span></a></li><li><ul><li><a href="#md:become-a-sponsor"><span>Become a <wbr/>Sponsor!</span></a></li></ul></li><li><a href="#md:🧪-cross-platform-testing"><span>🧪 <wbr/>Cross-<wbr/>Platform <wbr/>Testing</span></a></li><li><ul><li><a href="#md:automated-testing"><span>Automated <wbr/>Testing</span></a></li><li><a href="#md:example-apps"><span>Example <wbr/>Apps</span></a></li><li><a href="#md:how-it-works"><span>How <wbr/>It <wbr/>Works</span></a></li></ul></li><li><a href="#md:🏆-quality-assurance"><span>🏆 <wbr/>Quality <wbr/>Assurance</span></a></li><li><ul><li><a href="#md:test-statistics"><span>Test <wbr/>Statistics</span></a></li><li><a href="#md:quality-metrics"><span>Quality <wbr/>Metrics</span></a></li><li><a href="#md:reliability-features"><span>Reliability <wbr/>Features</span></a></li></ul></li><li><a href="#md:🚀-release-process"><span>🚀 <wbr/>Release <wbr/>Process</span></a></li><li><ul><li><a href="#md:automatic-release-workflow"><span>Automatic <wbr/>Release <wbr/>Workflow</span></a></li><li><a href="#md:manual-release-alternative"><span>Manual <wbr/>Release (<wbr/>Alternative)</span></a></li><li><a href="#md:commit-convention"><span>Commit <wbr/>Convention</span></a></li><li><a href="#md:how-version-detection-works"><span>How <wbr/>Version <wbr/>Detection <wbr/>Works</span></a></li><li><a href="#md:current-status"><span>Current <wbr/>Status</span></a></li></ul></li></ul></li></ul></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="index.html" class="current"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-1"></use></svg><span>@devlander/utils – Cross-Platform JavaScript Utility Functions - v1.0.8</span></a><ul class="tsd-small-nested-navigation" id="tsd-nav-container" data-base="."><details class="tsd-index-accordion" data-key="array-operations"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="#icon-chevronDown"></use></svg><span>array-operations</span></summary><div class="tsd-accordion-details"><ul class="tsd-nested-navigation"><li><a href="modules/array_operations_arrayToObject.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>arrayToObject</a></li><li><a href="modules/array_operations_chunkArray.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>chunkArray</a></li><li><a href="modules/array_operations_deduplicate.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>deduplicate</a></li><li><a href="modules/array_operations_filterAndSuggestItems.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>filterAndSuggestItems</a></li><li><a href="modules/array_operations_flattenArray.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>flattenArray</a></li><li><a href="modules/array_operations_forEach.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>forEach</a></li><li><a href="modules/array_operations_forEachEntry.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>forEachEntry</a></li><li><a href="modules/array_operations_getRandomValFromArray.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>getRandomValFromArray</a></li><li><a href="modules/array_operations_getRange.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>getRange</a></li><li><a href="modules/array_operations_getUniqueObjects.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>getUniqueObjects</a></li><li><a href="modules/array_operations_selectFromList.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>selectFromList</a></li><li><a href="modules/array_operations_shuffleArray.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>shuffleArray</a></li></ul></div></details><li><a href="modules/array_operations.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>array-operations</a></li><details class="tsd-index-accordion" data-key="base64-utilities"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="#icon-chevronDown"></use></svg><span>base64-utilities</span></summary><div class="tsd-accordion-details"><ul class="tsd-nested-navigation"><li><a href="modules/base64_utilities_convertBlobToBase64Native.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>convertBlobToBase64Native</a></li><li><a href="modules/base64_utilities_convertBlobToBase64Web.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>convertBlobToBase64Web</a></li><li><a href="modules/base64_utilities_decodeBase64ToString.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>decodeBase64ToString</a></li><li><a href="modules/base64_utilities_encodeStringToBase64.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>encodeStringToBase64</a></li><li><a href="modules/base64_utilities_isValidBase64.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>isValidBase64</a></li><li><a href="modules/base64_utilities_isValidBlob.html"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2"></use></svg>isValidBlob</a></li></ul></div></details><li>Loading...</li></ul></nav></div></div></div><div class="tsd-generator"><p>Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></div><div class="overlay"></div><svg style="display: none"><g id="icon-1"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-module)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.162 16V7.24H10.578L11.514 10.072C11.602 10.328 11.674 10.584 11.73 10.84C11.794 11.088 11.842 11.28 11.874 11.416C11.906 11.28 11.954 11.088 12.018 10.84C12.082 10.584 12.154 10.324 12.234 10.06L13.122 7.24H14.538V16H13.482V12.82C13.482 12.468 13.49 12.068 13.506 11.62C13.53 11.172 13.558 10.716 13.59 10.252C13.622 9.78 13.654 9.332 13.686 8.908C13.726 8.476 13.762 8.1 13.794 7.78L12.366 12.16H11.334L9.894 7.78C9.934 8.092 9.97 8.456 10.002 8.872C10.042 9.28 10.078 9.716 10.11 10.18C10.142 10.636 10.166 11.092 10.182 11.548C10.206 12.004 10.218 12.428 10.218 12.82V16H9.162Z" fill="var(--color-text)"></path></g><g id="icon-2"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-module)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.162 16V7.24H10.578L11.514 10.072C11.602 10.328 11.674 10.584 11.73 10.84C11.794 11.088 11.842 11.28 11.874 11.416C11.906 11.28 11.954 11.088 12.018 10.84C12.082 10.584 12.154 10.324 12.234 10.06L13.122 7.24H14.538V16H13.482V12.82C13.482 12.468 13.49 12.068 13.506 11.62C13.53 11.172 13.558 10.716 13.59 10.252C13.622 9.78 13.654 9.332 13.686 8.908C13.726 8.476 13.762 8.1 13.794 7.78L12.366 12.16H11.334L9.894 7.78C9.934 8.092 9.97 8.456 10.002 8.872C10.042 9.28 10.078 9.716 10.11 10.18C10.142 10.636 10.166 11.092 10.182 11.548C10.206 12.004 10.218 12.428 10.218 12.82V16H9.162Z" fill="var(--color-text)"></path></g><g id="icon-4"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-namespace)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.33 16V7.24H10.77L13.446 14.74C13.43 14.54 13.41 14.296 13.386 14.008C13.37 13.712 13.354 13.404 13.338 13.084C13.33 12.756 13.326 12.448 13.326 12.16V7.24H14.37V16H12.93L10.266 8.5C10.282 8.692 10.298 8.936 10.314 9.232C10.33 9.52 10.342 9.828 10.35 10.156C10.366 10.476 10.374 10.784 10.374 11.08V16H9.33Z" fill="var(--color-text)"></path></g><g id="icon-8"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-enum)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.45 16V7.24H14.49V8.224H10.518V10.936H14.07V11.908H10.518V15.016H14.49V16H9.45Z" fill="var(--color-text)"></path></g><g id="icon-16"><rect fill="var(--color-icon-background)" stroke="#FF984D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M9.354 16V7.24H12.174C12.99 7.24 13.638 7.476 14.118 7.948C14.606 8.412 14.85 9.036 14.85 9.82C14.85 10.604 14.606 11.232 14.118 11.704C13.638 12.168 12.99 12.4 12.174 12.4H10.434V16H9.354ZM10.434 11.428H12.174C12.646 11.428 13.022 11.284 13.302 10.996C13.59 10.7 13.734 10.308 13.734 9.82C13.734 9.324 13.59 8.932 13.302 8.644C13.022 8.356 12.646 8.212 12.174 8.212H10.434V11.428Z" fill="var(--color-text)"></path></g><g id="icon-32"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-variable)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M11.106 16L8.85 7.24H9.966L11.454 13.192C11.558 13.608 11.646 13.996 11.718 14.356C11.79 14.708 11.842 14.976 11.874 15.16C11.906 14.976 11.954 14.708 12.018 14.356C12.09 13.996 12.178 13.608 12.282 13.192L13.758 7.24H14.85L12.582 16H11.106Z" fill="var(--color-text)"></path></g><g id="icon-64"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-function)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.39 16V7.24H14.55V8.224H10.446V11.128H14.238V12.112H10.47V16H9.39Z" fill="var(--color-text)"></path></g><g id="icon-128"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-class)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M11.898 16.1201C11.098 16.1201 10.466 15.8961 10.002 15.4481C9.53803 15.0001 9.30603 14.3841 9.30603 13.6001V9.64012C9.30603 8.85612 9.53803 8.24012 10.002 7.79212C10.466 7.34412 11.098 7.12012 11.898 7.12012C12.682 7.12012 13.306 7.34812 13.77 7.80412C14.234 8.25212 14.466 8.86412 14.466 9.64012H13.386C13.386 9.14412 13.254 8.76412 12.99 8.50012C12.734 8.22812 12.37 8.09212 11.898 8.09212C11.426 8.09212 11.054 8.22412 10.782 8.48812C10.518 8.75212 10.386 9.13212 10.386 9.62812V13.6001C10.386 14.0961 10.518 14.4801 10.782 14.7521C11.054 15.0161 11.426 15.1481 11.898 15.1481C12.37 15.1481 12.734 15.0161 12.99 14.7521C13.254 14.4801 13.386 14.0961 13.386 13.6001H14.466C14.466 14.3761 14.234 14.9921 13.77 15.4481C13.306 15.8961 12.682 16.1201 11.898 16.1201Z" fill="var(--color-text)"></path></g><g id="icon-256"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-interface)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.51 16V15.016H11.298V8.224H9.51V7.24H14.19V8.224H12.402V15.016H14.19V16H9.51Z" fill="var(--color-text)"></path></g><g id="icon-512"><rect fill="var(--color-icon-background)" stroke="#4D7FFF" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M11.898 16.1201C11.098 16.1201 10.466 15.8961 10.002 15.4481C9.53803 15.0001 9.30603 14.3841 9.30603 13.6001V9.64012C9.30603 8.85612 9.53803 8.24012 10.002 7.79212C10.466 7.34412 11.098 7.12012 11.898 7.12012C12.682 7.12012 13.306 7.34812 13.77 7.80412C14.234 8.25212 14.466 8.86412 14.466 9.64012H13.386C13.386 9.14412 13.254 8.76412 12.99 8.50012C12.734 8.22812 12.37 8.09212 11.898 8.09212C11.426 8.09212 11.054 8.22412 10.782 8.48812C10.518 8.75212 10.386 9.13212 10.386 9.62812V13.6001C10.386 14.0961 10.518 14.4801 10.782 14.7521C11.054 15.0161 11.426 15.1481 11.898 15.1481C12.37 15.1481 12.734 15.0161 12.99 14.7521C13.254 14.4801 13.386 14.0961 13.386 13.6001H14.466C14.466 14.3761 14.234 14.9921 13.77 15.4481C13.306 15.8961 12.682 16.1201 11.898 16.1201Z" fill="var(--color-text)"></path></g><g id="icon-1024"><rect fill="var(--color-icon-background)" stroke="#FF984D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M9.354 16V7.24H12.174C12.99 7.24 13.638 7.476 14.118 7.948C14.606 8.412 14.85 9.036 14.85 9.82C14.85 10.604 14.606 11.232 14.118 11.704C13.638 12.168 12.99 12.4 12.174 12.4H10.434V16H9.354ZM10.434 11.428H12.174C12.646 11.428 13.022 11.284 13.302 10.996C13.59 10.7 13.734 10.308 13.734 9.82C13.734 9.324 13.59 8.932 13.302 8.644C13.022 8.356 12.646 8.212 12.174 8.212H10.434V11.428Z" fill="var(--color-text)"></path></g><g id="icon-2048"><rect fill="var(--color-icon-background)" stroke="#FF4DB8" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M9.162 16V7.24H10.578L11.514 10.072C11.602 10.328 11.674 10.584 11.73 10.84C11.794 11.088 11.842 11.28 11.874 11.416C11.906 11.28 11.954 11.088 12.018 10.84C12.082 10.584 12.154 10.324 12.234 10.06L13.122 7.24H14.538V16H13.482V12.82C13.482 12.468 13.49 12.068 13.506 11.62C13.53 11.172 13.558 10.716 13.59 10.252C13.622 9.78 13.654 9.332 13.686 8.908C13.726 8.476 13.762 8.1 13.794 7.78L12.366 12.16H11.334L9.894 7.78C9.934 8.092 9.97 8.456 10.002 8.872C10.042 9.28 10.078 9.716 10.11 10.18C10.142 10.636 10.166 11.092 10.182 11.548C10.206 12.004 10.218 12.428 10.218 12.82V16H9.162Z" fill="var(--color-text)"></path></g><g id="icon-4096"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-function)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M9.39 16V7.24H14.55V8.224H10.446V11.128H14.238V12.112H10.47V16H9.39Z" fill="var(--color-text)"></path></g><g id="icon-8192"><rect fill="var(--color-icon-background)" stroke="#FF984D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M9.354 16V7.24H12.174C12.99 7.24 13.638 7.476 14.118 7.948C14.606 8.412 14.85 9.036 14.85 9.82C14.85 10.604 14.606 11.232 14.118 11.704C13.638 12.168 12.99 12.4 12.174 12.4H10.434V16H9.354ZM10.434 11.428H12.174C12.646 11.428 13.022 11.284 13.302 10.996C13.59 10.7 13.734 10.308 13.734 9.82C13.734 9.324 13.59 8.932 13.302 8.644C13.022 8.356 12.646 8.212 12.174 8.212H10.434V11.428Z" fill="var(--color-text)"></path></g><g id="icon-16384"><rect fill="var(--color-icon-background)" stroke="#4D7FFF" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M11.898 16.1201C11.098 16.1201 10.466 15.8961 10.002 15.4481C9.53803 15.0001 9.30603 14.3841 9.30603 13.6001V9.64012C9.30603 8.85612 9.53803 8.24012 10.002 7.79212C10.466 7.34412 11.098 7.12012 11.898 7.12012C12.682 7.12012 13.306 7.34812 13.77 7.80412C14.234 8.25212 14.466 8.86412 14.466 9.64012H13.386C13.386 9.14412 13.254 8.76412 12.99 8.50012C12.734 8.22812 12.37 8.09212 11.898 8.09212C11.426 8.09212 11.054 8.22412 10.782 8.48812C10.518 8.75212 10.386 9.13212 10.386 9.62812V13.6001C10.386 14.0961 10.518 14.4801 10.782 14.7521C11.054 15.0161 11.426 15.1481 11.898 15.1481C12.37 15.1481 12.734 15.0161 12.99 14.7521C13.254 14.4801 13.386 14.0961 13.386 13.6001H14.466C14.466 14.3761 14.234 14.9921 13.77 15.4481C13.306 15.8961 12.682 16.1201 11.898 16.1201Z" fill="var(--color-text)"></path></g><g id="icon-32768"><rect fill="var(--color-icon-background)" stroke="#FF984D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M9.354 16V7.24H12.174C12.99 7.24 13.638 7.476 14.118 7.948C14.606 8.412 14.85 9.036 14.85 9.82C14.85 10.604 14.606 11.232 14.118 11.704C13.638 12.168 12.99 12.4 12.174 12.4H10.434V16H9.354ZM10.434 11.428H12.174C12.646 11.428 13.022 11.284 13.302 10.996C13.59 10.7 13.734 10.308 13.734 9.82C13.734 9.324 13.59 8.932 13.302 8.644C13.022 8.356 12.646 8.212 12.174 8.212H10.434V11.428Z" fill="var(--color-text)"></path></g><g id="icon-65536"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-type-alias)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M11.31 16V8.224H8.91V7.24H14.79V8.224H12.39V16H11.31Z" fill="var(--color-text)"></path></g><g id="icon-131072"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-type-alias)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M11.31 16V8.224H8.91V7.24H14.79V8.224H12.39V16H11.31Z" fill="var(--color-text)"></path></g><g id="icon-262144"><rect fill="var(--color-icon-background)" stroke="#FF4D4D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M8.85 16L11.13 7.24H12.582L14.85 16H13.758L13.182 13.672H10.53L9.954 16H8.85ZM10.746 12.76H12.954L12.282 10.06C12.154 9.548 12.054 9.12 11.982 8.776C11.91 8.432 11.866 8.208 11.85 8.104C11.834 8.208 11.79 8.432 11.718 8.776C11.646 9.12 11.546 9.544 11.418 10.048L10.746 12.76Z" fill="var(--color-text)"></path></g><g id="icon-524288"><rect fill="var(--color-icon-background)" stroke="#FF4D4D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M8.85 16L11.13 7.24H12.582L14.85 16H13.758L13.182 13.672H10.53L9.954 16H8.85ZM10.746 12.76H12.954L12.282 10.06C12.154 9.548 12.054 9.12 11.982 8.776C11.91 8.432 11.866 8.208 11.85 8.104C11.834 8.208 11.79 8.432 11.718 8.776C11.646 9.12 11.546 9.544 11.418 10.048L10.746 12.76Z" fill="var(--color-text)"></path></g><g id="icon-1048576"><rect fill="var(--color-icon-background)" stroke="#FF4D4D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M8.85 16L11.13 7.24H12.582L14.85 16H13.758L13.182 13.672H10.53L9.954 16H8.85ZM10.746 12.76H12.954L12.282 10.06C12.154 9.548 12.054 9.12 11.982 8.776C11.91 8.432 11.866 8.208 11.85 8.104C11.834 8.208 11.79 8.432 11.718 8.776C11.646 9.12 11.546 9.544 11.418 10.048L10.746 12.76Z" fill="var(--color-text)"></path></g><g id="icon-2097152"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-type-alias)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6"></rect><path d="M11.31 16V8.224H8.91V7.24H14.79V8.224H12.39V16H11.31Z" fill="var(--color-text)"></path></g><g id="icon-4194304"><rect fill="var(--color-icon-background)" stroke="#FF4D82" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12"></rect><path d="M10.354 17V8.24H13.066C13.586 8.24 14.042 8.348 14.434 8.564C14.826 8.772 15.13 9.064 15.346 9.44C15.562 9.816 15.67 10.256 15.67 10.76C15.67 11.352 15.514 11.86 15.202 12.284C14.898 12.708 14.482 13 13.954 13.16L15.79 17H14.518L12.838 13.28H11.434V17H10.354ZM11.434 12.308H13.066C13.514 12.308 13.874 12.168 14.146 11.888C14.418 11.6 14.554 11.224 14.554 10.76C14.554 10.288 14.418 9.912 14.146 9.632C13.874 9.352 13.514 9.212 13.066 9.212H11.434V12.308Z" fill="var(--color-text)"></path></g><g id="icon-chevronDown"><path d="M4.93896 8.531L12 15.591L19.061 8.531L16.939 6.409L12 11.349L7.06098 6.409L4.93896 8.531Z" fill="var(--color-text)"></path></g><g id="icon-chevronSmall"><path d="M1.5 5.50969L8 11.6609L14.5 5.50969L12.5466 3.66086L8 7.96494L3.45341 3.66086L1.5 5.50969Z" fill="var(--color-text)"></path></g><g id="icon-menu"><rect x="1" y="3" width="14" height="2" fill="var(--color-text)"></rect><rect x="1" y="7" width="14" height="2" fill="var(--color-text)"></rect><rect x="1" y="11" width="14" height="2" fill="var(--color-text)"></rect></g><g id="icon-search"><path d="M15.7824 13.833L12.6666 10.7177C12.5259 10.5771 12.3353 10.499 12.1353 10.499H11.6259C12.4884 9.39596 13.001 8.00859 13.001 6.49937C13.001 2.90909 10.0914 0 6.50048 0C2.90959 0 0 2.90909 0 6.49937C0 10.0896 2.90959 12.9987 6.50048 12.9987C8.00996 12.9987 9.39756 12.4863 10.5008 11.6239V12.1332C10.5008 12.3332 10.5789 12.5238 10.7195 12.6644L13.8354 15.7797C14.1292 16.0734 14.6042 16.0734 14.8948 15.7797L15.7793 14.8954C16.0731 14.6017 16.0731 14.1267 15.7824 13.833ZM6.50048 10.499C4.29094 10.499 2.50018 8.71165 2.50018 6.49937C2.50018 4.29021 4.28781 2.49976 6.50048 2.49976C8.71001 2.49976 10.5008 4.28708 10.5008 6.49937C10.5008 8.70852 8.71314 10.499 6.50048 10.499Z" fill="var(--color-text)"></path></g><g id="icon-anchor"><g stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"></path><path d="M10 14a3.5 3.5 0 0 0 5 0l4 -4a3.5 3.5 0 0 0 -5 -5l-.5 .5"></path><path d="M14 10a3.5 3.5 0 0 0 -5 0l-4 4a3.5 3.5 0 0 0 5 5l.5 -.5"></path></g></g></svg></body></html>