Funzione Sovraccarico tramite polimorfismo dinamico in 100 linee di JS
Questo è da un insieme più grande di codice che comprende i isFn
, isArr
ecc tipo funzioni di controllo. La versione VanillaJS di seguito è stata rielaborata per rimuovere tutte le dipendenze esterne, tuttavia dovrai definire le tue funzioni di controllo del tipo da utilizzare nelle .add()
chiamate.
Nota: questa è una funzione di auto-esecuzione (quindi possiamo avere un ambito di chiusura / ambito chiuso), quindi l'assegnazione a window.overload
piuttosto che function overload() {...}
.
window.overload = function () {
"use strict"
var a_fnOverloads = [],
_Object_prototype_toString = Object.prototype.toString
;
function isFn(f) {
return (_Object_prototype_toString.call(f) === '[object Function]');
} //# isFn
function isObj(o) {
return !!(o && o === Object(o));
} //# isObj
function isArr(a) {
return (_Object_prototype_toString.call(a) === '[object Array]');
} //# isArr
function mkArr(a) {
return Array.prototype.slice.call(a);
} //# mkArr
function fnCall(fn, vContext, vArguments) {
//# <ES5 Support for array-like objects
//# See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/apply#Browser_compatibility
vArguments = (isArr(vArguments) ? vArguments : mkArr(vArguments));
if (isFn(fn)) {
return fn.apply(vContext || this, vArguments);
}
} //# fnCall
//#
function registerAlias(fnOverload, fn, sAlias) {
//#
if (sAlias && !fnOverload[sAlias]) {
fnOverload[sAlias] = fn;
}
} //# registerAlias
//#
function overload(vOptions) {
var oData = (isFn(vOptions) ?
{ default: vOptions } :
(isObj(vOptions) ?
vOptions :
{
default: function (/*arguments*/) {
throw "Overload not found for arguments: [" + mkArr(arguments) + "]";
}
}
)
),
fnOverload = function (/*arguments*/) {
var oEntry, i, j,
a = arguments,
oArgumentTests = oData[a.length] || []
;
//# Traverse the oArgumentTests for the number of passed a(rguments), defaulting the oEntry at the beginning of each loop
for (i = 0; i < oArgumentTests.length; i++) {
oEntry = oArgumentTests[i];
//# Traverse the passed a(rguments), if a .test for the current oArgumentTests fails, reset oEntry and fall from the a(rgument)s loop
for (j = 0; j < a.length; j++) {
if (!oArgumentTests[i].tests[j](a[j])) {
oEntry = undefined;
break;
}
}
//# If all of the a(rgument)s passed the .tests we found our oEntry, so break from the oArgumentTests loop
if (oEntry) {
break;
}
}
//# If we found our oEntry above, .fn.call its .fn
if (oEntry) {
oEntry.calls++;
return fnCall(oEntry.fn, this, a);
}
//# Else we were unable to find a matching oArgumentTests oEntry, so .fn.call our .default
else {
return fnCall(oData.default, this, a);
}
} //# fnOverload
;
//#
fnOverload.add = function (fn, a_vArgumentTests, sAlias) {
var i,
bValid = isFn(fn),
iLen = (isArr(a_vArgumentTests) ? a_vArgumentTests.length : 0)
;
//#
if (bValid) {
//# Traverse the a_vArgumentTests, processinge each to ensure they are functions (or references to )
for (i = 0; i < iLen; i++) {
if (!isFn(a_vArgumentTests[i])) {
bValid = _false;
}
}
}
//# If the a_vArgumentTests are bValid, set the info into oData under the a_vArgumentTests's iLen
if (bValid) {
oData[iLen] = oData[iLen] || [];
oData[iLen].push({
fn: fn,
tests: a_vArgumentTests,
calls: 0
});
//#
registerAlias(fnOverload, fn, sAlias);
return fnOverload;
}
//# Else one of the passed arguments was not bValid, so throw the error
else {
throw "poly.overload: All tests must be functions or strings referencing `is.*`.";
}
}; //# overload*.add
//#
fnOverload.list = function (iArgumentCount) {
return (arguments.length > 0 ? oData[iArgumentCount] || [] : oData);
}; //# overload*.list
//#
a_fnOverloads.push(fnOverload);
registerAlias(fnOverload, oData.default, "default");
return fnOverload;
} //# overload
//#
overload.is = function (fnTarget) {
return (a_fnOverloads.indexOf(fnTarget) > -1);
} //# overload.is
return overload;
}();
Uso:
Il chiamante definisce le funzioni sovraccaricate assegnando una variabile al ritorno di overload()
. Grazie al concatenamento, i sovraccarichi aggiuntivi possono essere definiti in serie:
var myOverloadedFn = overload(function(){ console.log("default", arguments) })
.add(function(){ console.log("noArgs", arguments) }, [], "noArgs")
.add(function(){ console.log("str", arguments) }, [function(s){ return typeof s === 'string' }], "str")
;
L'unico argomento facoltativo per overload()
definire la funzione "predefinita" da chiamare se non è possibile identificare la firma. Gli argomenti .add()
sono:
fn
: function
definizione del sovraccarico;
a_vArgumentTests
: Array
di function
definire i test da eseguire sul arguments
. Ciascuno function
accetta un singolo argomento e restituisce il true
tuo basato su se l'argomento è valido;
sAlias
(Opzionale): string
definire l'alias per accedere direttamente alla funzione di sovraccarico ( fn
), ad esempio myOverloadedFn.noArgs()
chiamerà direttamente quella funzione, evitando i test di polimorfismo dinamico degli argomenti.
Questa implementazione in realtà consente oltre ai tradizionali sovraccarichi di funzioni poiché il secondo a_vArgumentTests
argomento .add()
in pratica definisce i tipi personalizzati. Quindi, potresti trasferire argomenti non solo in base al tipo, ma a intervalli, valori o raccolte di valori!
Se guardi attraverso le 145 righe di codice overload()
, vedrai che ogni firma è classificata in base al numero di arguments
passati ad essa. Questo viene fatto in modo da limitare il numero di test che stiamo eseguendo. Tengo anche traccia del conteggio delle chiamate. Con un po 'di codice aggiuntivo, gli array di funzioni sovraccaricate potrebbero essere riordinati in modo che i test più comunemente chiamati vengano testati per primi, aggiungendo di nuovo un po' di miglioramento delle prestazioni.
Ora, ci sono alcuni avvertimenti ... Dato che Javascript è scritto in modo approssimativo, dovrai stare attento con il tuo vArgumentTests
come integer
potrebbe essere convalidato come un float
, ecc.
Versione JSCompress.com (1114 byte, 744 byte con zip g):
window.overload=function(){'use strict';function b(n){return'[object Function]'===m.call(n)}function c(n){return!!(n&&n===Object(n))}function d(n){return'[object Array]'===m.call(n)}function e(n){return Array.prototype.slice.call(n)}function g(n,p,q){if(q=d(q)?q:e(q),b(n))return n.apply(p||this,q)}function h(n,p,q){q&&!n[q]&&(n[q]=p)}function k(n){var p=b(n)?{default:n}:c(n)?n:{default:function(){throw'Overload not found for arguments: ['+e(arguments)+']'}},q=function(){var r,s,t,u=arguments,v=p[u.length]||[];for(s=0;s<v.length;s++){for(r=v[s],t=0;t<u.length;t++)if(!v[s].tests[t](u[t])){r=void 0;break}if(r)break}return r?(r.calls++,g(r.fn,this,u)):g(p.default,this,u)};return q.add=function(r,s,t){var u,v=b(r),w=d(s)?s.length:0;if(v)for(u=0;u<w;u++)b(s[u])||(v=_false);if(v)return p[w]=p[w]||[],p[w].push({fn:r,tests:s,calls:0}),h(q,r,t),q;throw'poly.overload: All tests must be functions or strings referencing `is.*`.'},q.list=function(r){return 0<arguments.length?p[r]||[]:p},l.push(q),h(q,p.default,'default'),q}var l=[],m=Object.prototype.toString;return k.is=function(n){return-1<l.indexOf(n)},k}();