jlang - A modern JavaScript utility library inspired by PHP, Python, providing handy functions like isset(), isArray(), and other missing utilities in native JavaScript.
npm install jlangisset(), empty(), and other utility functions.
bash
npm install jlang
`
Quick Start
`js
const { isset, isEmpty, isArray, toJson,fromJson } = require('jlang');
// Check if variable exists (like PHP's isset)
if (isset(variable)) {
console.log('Variable exists!');
}
// Check if value is empty
if (isEmpty(data)) {
console.log('Data is empty');
}
// Check if value is an array
if (isArray(myList)) {
console.log('It\'s an array!');
}
// JSON utilities
const jsonString = toJson({ name: 'John' });
const parsed = fromJson(jsonString);
`
---
𧩠Modules et méthodes
$3
đ Ce module contient des mĂ©thodes pour tester des valeurs.
| MĂ©thode | Description | Natifs JS existants |
| ----------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| isset(value) | VĂ©rifie que la valeur nâest ni null ni undefined. | â (JS utilise typeof ⊠!== 'undefined' && value !== null) ([Stack Overflow][2]) |
| isEmpty(value) | VĂ©rifie si une valeur est âvideâ (string vide, array vide, object sans clĂ©s). | â |
| isArray(value) | VĂ©rifie si câest un Array. | Existe : Array.isArray() ([MDN Web Docs][3]) |
| string(value) | VĂ©rifie si câest une String. - en dĂ©veloppement | â |
| isAlpha(str) | VĂ©rifie si tous les caractĂšres sont alphabĂ©tiques, comme ctype_alpha de PHP. | â (disponibles dans locutus/php/ctype) ([Locutus][4]) |
| hasAlpha(str) | VĂ©rifie si la chaine contient au moins un caractĂšre alphabĂ©tique, comme ctype_alpha de PHP. | â (disponibles dans locutus/php/ctype) ([Locutus][4]) |
---
đ Exemple dâutilisation
`js
import { is } from './index.js';
if (is.isset(userInput) && Is.array(data)) {
console.log('Valid array:', data);
}
import { isset,isArray } from './index.js';
if (isset(userInput) && isArray(data)) {
console.log('Valid array:', data);
}
`
---
đ RĂšgles de contribution
1. Avant dâajouter une mĂ©thode, vĂ©rifie si elle :
* Existe déjà dans JS natif.
* Est fournie par une bibliothĂšque utilitaire reconnue (ex. Lodash, utilitiesâjs) ([IronPDF][6]).
2. Chaque mĂ©thode doit ĂȘtre testĂ©e (tests unitaires).
3. Respecter les conventions de nommage et structure modulaire.
4. Les mĂ©thodes doivent ĂȘtre pures (sans sideâeffects) autant que possible.
5. Documenter chaque nouvelle méthode dans le README.
---
đ§Ș Tests
Ajouter des tests dans un dossier tests/ avec un runner comme Jest ou Vitest. Couvre :
* Cas normaux
* Cas limites (null, undefined`, chaĂźnes vides, tableaux vides, etc.)