Il seguente modulo contiene utilità generali.

• Exports
  • initExceptionHandler
  • bindTrailingArgs
  • merge
  • push
  • removeByIndex
  • remove
  • modifyByIndex
  • modify
• Development

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

1. 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

1. function (function): funzione alla quale devono essere applicati gli arguments
2. 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

1. 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

1. array (Array): array a cui aggiungere gli elementi
2. 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

1. array (Array): array da cui rimuovere l'elemento
2. 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

1. array (Array): array da cui rimuovere l'elemento
2. 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

1. array (Array): array da cui rimuovere l'elemento
2. index (Number): indice dell'oggetto da modificare
3. 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

1. array (Array): array da cui rimuovere l'elemento
2. item (any): oggetto da modificare
3. 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