Isto é um parâmetro. Um argumento será passado para ele. Imagino que mesmo não sabendo a terminologia correta, saiba para que serve um parâmetro.
Neste caso o e
irá receber argumentos enviados pela função each()
. Esta função tem por objetivo varrer uma coleção de dados. Então cada membro desta coleção provocará uma chamada à função anônima escrita ali e o elemento da coleção (neste caso, o índice dele) será enviado como argumento.
Na verdade estou descrevendo o que eu sei desta função. Funções que chamam funções anônimas devem documentar bem como a função anônima (que você escreveu) deve ser escrita, que parâmetros ela deve receber, em linhas gerais o que ela deve fazer e o que deve retornar.
E obviamente que você pode escrever uma função sua que receba como argumento uma função anônima. Se fizer isto, tem que documentar como ela será usada.
Vamos ver o fonte da função each()
:
function (obj, callback) {
var length, i = 0;
if (isArrayLike(obj)) {
length = obj.length;
for (; i < length; i++) if (callback.call(obj[i], i, obj[i]) === false) break;
} else for (i in obj) if (callback.call(obj[i], i, obj[i]) === false) break;
return obj;
}
Coloquei no GitHub para referência futura.
O callback.call
é que faz a chamada à sua função. Os parâmetros desta função são:
thisArg
- que é o elemento
arg1
e arg2
- que é o índice e novamente o elemento
O arg1
é que realmente será passado como argumento para a sua função anônima. No caso ele é expressado pela variável i
no laço.
Se a sua função declarar os parâmetros como (i, e)
você poderá receber o índice e o elemento sendo analisado naquela iteração. Em algumas situações basta receber o índice, em outras também precisa conhecer o elemento exato.
Um adendo final: quase sempre um loop comum resolve tão bem ou melhor que o uso da função each()
.
e
era normalmente usado para eventos, ouevent
. Mas generalizou e todos começaram a usare
, sem de fato entender o porque. Mas não necessariamente precisa chamare
.