Core: deprecate jQuery.proxy (not slated for removal)

Fixes gh-2958
Close gh-3885

1 files changed, 34 insertions, 2 deletions

diff --git a/src/deprecated.js b/src/deprecated.js
index 74907a289..8523ee5b8 100644
--- a/src/deprecated.js
+++ b/src/deprecated.js
@@ -2,8 +2,9 @@ define( [
 	"./core",
 	"./core/nodeName",
 	"./core/camelCase",
-	"./var/isWindow"
-], function( jQuery, nodeName, camelCase, isWindow ) {
+	"./var/isWindow",
+	"./var/slice"
+], function( jQuery, nodeName, camelCase, isWindow, slice ) {
 
 "use strict";
 
@@ -28,6 +29,37 @@ jQuery.fn.extend( {
 	}
 } );
 
+// Bind a function to a context, optionally partially applying any
+// arguments.
+// jQuery.proxy is deprecated to promote standards (specifically Function#bind)
+// However, it is not slated for removal any time soon
+jQuery.proxy = function( fn, context ) {
+	var tmp, args, proxy;
+
+	if ( typeof context === "string" ) {
+		tmp = fn[ context ];
+		context = fn;
+		fn = tmp;
+	}
+
+	// Quick check to determine if target is callable, in the spec
+	// this throws a TypeError, but we will just return undefined.
+	if ( !jQuery.isFunction( fn ) ) {
+		return undefined;
+	}
+
+	// Simulated bind
+	args = slice.call( arguments, 2 );
+	proxy = function() {
+		return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
+	};
+
+	// Set the guid of unique handler to the same of original handler, so it can be removed
+	proxy.guid = fn.guid = fn.guid || jQuery.guid++;
+
+	return proxy;
+};
+
 jQuery.holdReady = function( hold ) {
 	if ( hold ) {
 		jQuery.readyWait++;