Il seguente modulo contiene utilità generali.
Exports
initExceptionHandler (exceptionHandler)
Esegue l'inizializzazione dell'interceptor degli errori. L'exceptionHandler sarà corrispondente a quello inviato come parametro, alternativamente sarà utilizzato quello di default che effettuerà un semplice log.
Arguments
- exceptionHandler (function): funzione da richiamare quando viene sollevato un errore non gestito
Returns
void
Esempio
initExceptionHandler();
initExceptionHandler( (message, filename, lineNumber, colNumber, error) => {
// handle error here
} );
bindTrailingArgs (function, args...)
Data una funzione e un numero n di parametri, ritorna una nuova funzione corrispondente a quella data effettuando il bind degli ultimi parametri
Arguments
- function (function): funzione alla quale devono essere applicati gli arguments
- args... (any): parametri da applicare alla funzione data
Returns
(function): una nuova funzione alla quale è stato applicato il bind degli arguments a partire dagli ultimi n
Esempio
const sum = (x, y) => {
return x + y;
};
const sum5 = bindTrailingArgs(sum, 5);
sum5(2); // sum(2, 5)
merge (args...)
Dati n oggetti, ritorna un oggetto equivalente al loro merge.
Arguments
- args... (object): oggetti soggetti al merge
Returns
(object): oggetto corrispondente al merge di quelli ottenuti dagli args
Esempio
const state = {
locale: "it",
messages: ...
};
const result = merge(state, {
locale: "en",
}); // { locale: "en", messages: ... }
push (array, args...)
Dato un array e un numero n di oggetti, ritorna un nuovo array dopo aver effettuato il push degli elementi dati.
Arguments
- array (Array): array a cui aggiungere gli elementi
- args... (any): oggetti da aggiungere all'array
Returns
(Array): array contenente gli elementi dell'array dato e quelli inviati come parametri
Esempio
const array = [0, 1, 2];
const newArray = push(array, 3, 4, 5) // [0, 1, 2, 3, 4, 5]
removeByIndex (array, index)
Rimuove dall'array fornito come parametro l'elemento presente al corrispondente indice.
Arguments
- array (Array): array da cui rimuovere l'elemento
- index (Number): indice dell'oggetto da rimuovere
Returns
(Array): nuovo array senza l'elemento da rimuovere
Esempio
const array = [0, 1, 2];
const newArray = removeByIndex(array, 1) // [0, 2]
remove (array, item)
Rimuove dall'array fornito come parametro l'elemento dato.
Arguments
- array (Array): array da cui rimuovere l'elemento
- item (any): oggetto da rimuovere
Returns
(Array): nuovo array senza l'elemento da rimuovere
Esempio
const array = ["example1", "example2", "example3"];
const newArray = remove(array, "example1") // ["example2", "example3"]
modifyByIndex (array, index, func)
Modifica l'elemento presente all'indice dato nell'array fornito.
Arguments
- array (Array): array da cui rimuovere l'elemento
- index (Number): indice dell'oggetto da modificare
- func (function): funzione da applicare all'elemento presente nell'array all'indice dato
Returns
(Array): nuovo array con l'elemento modificato
Esempio
const array = [0, 1, 2];
const func = (i) => {
return i + 1;
}
const newArray = modifyByIndex(array, 1, func) // [0, 2, 2]
modify (array, item, func)
Modifica l'elemento presente nell'array fornito.
Arguments
- array (Array): array da cui rimuovere l'elemento
- item (any): oggetto da modificare
- func (function): funzione da applicare all'elemento presente nell'array
Returns
(Array): nuovo array con l'elemento modificato
Esempio
const array = ["foo", "bar", "John"];
const func = (name) => {
return "Hello " + name;
}
const newArray = modifyByIndex(array, "bar", func) // ["foo", "Hello bar", "John"]
Development
Possono essere aggiunte funzionalità al seguente modulo rispettando le seguenti direttive:
- Piccole funzioni possono essere aggiunte nel file
src/util.js
- Funzione di complessità maggiore devono essere incluse in file specifici
Le funzioni aggiunte devono essere sancite per essere esportate nel file index.js