Evénements - but principal de eventsApi()?

Question

Conceptuellement, que fait eventsApi()? Il est privé à Backbone mais utilisé dans 4 méthodes d'événements publics - on(), once(), off() et trigger().

Dans chacun d'eux, si elle renvoie une valeur non-vérité, la méthode l'appelant quittera "early".

Une chose à faire est de déterminer si la seconde partie de la méthode appelante sera exécutée. Si name n'est pas véridique ou n'est pas un type complexe (chaînes séparées par un objet ou un espace), il retournera un vrai permettant l'exécution de la seconde partie de la méthode.

Quel est l'objectif principal de la fonction eventsApi, conceptuellement, car j'ai essayé de décrire ce qu'elle fait fonctionnellement/logiquement?

eventsAPI

var eventsApi = function(obj, action, name, rest) { 
    if (!name) return true; 
    if (typeof name === 'object') { 
     for (var key in name) { 
     obj[action].apply(obj, [key, name[key]].concat(rest)); 
     } 
    } else if (eventSplitter.test(name)) { 
     var names = name.split(eventSplitter); 
     for (var i = 0, l = names.length; i < l; i++) { 
     obj[action].apply(obj, [names[i]].concat(rest)); 
     } 
    } else { 
     return true; 
    } 
    }; 

Answer 1

Comme le commentaire dans la source dit, il met en œuvre les usages plus fantaisie de l'API des événements.

// Implement fancy features of the Events API such as multiple event 
// names `"change blur"` and jQuery-style event maps `{change: action}` 
// in terms of the existing API. 

Ainsi, lorsque vous utilisez l'API Events avec une carte de l'événement:

book.on({ 
    "change:title": titleView.update, 
    "change:author": authorPane.update, 
    "destroy": bookView.remove 
}); 

La fonction eventsApi détecte que l'entrée est un objet, et appelle on à nouveau pour chacune des propriétés transmis.

L'autre cas, il gère les événements est séparé de l'espace:

book.on("change:title change:author", ...); 

Dans ce cas, la fonction eventsApi détecte cette situation et, encore une fois, une fois pour les appels on chacun des événements transmis.