JQuery 库模块导出
JQuery library module export
我正在尝试了解 jQuery 是如何自我设置的。
在开头jQuery自动调用一个函数,导出一个模块。
设置如何工作?
这里有一些更详细的子问题,可以回答更一般的问题:
- 在
module.exports
递归调用function(w)
有什么用?
noGlobal
变量有什么用?
factory
实际设置在哪里,它的类型是什么?
- 为什么
factory
参数可以用一个参数调用,也可以用两个参数调用?
global
参数应该包含什么? (我希望有一个类似于 c++ 的类型...)
(function( global, factory ) {
if ( typeof module === "object" && typeof module.exports === "object" ) {
// For CommonJS and CommonJS-like environments where a proper `window`
// is present, execute the factory and get jQuery.
// For environments that do not have a `window` with a `document`
// (such as Node.js), expose a factory as module.exports.
// This accentuates the need for the creation of a real `window`.
// e.g. var jQuery = require("jquery")(window);
// See ticket #14549 for more info.
module.exports = global.document ?
factory( global, true ) :
function( w ) {
if ( !w.document ) {
throw new Error( "jQuery requires a window with a document" );
}
return factory( w );
};
} else {
factory( global );
}
// Pass this if window is not defined yet
}(typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
What is the use of the recursive call to function(w)
at module.exports
?
这不是递归调用,更像是一个延迟初始化函数。在某些 CommonJS 环境中,如 Node.JS,全局对象没有 document
属性,而其他环境,如 Browserify 和 Webpack 则有。
jQuery需要document
属性来初始化,所以它首先检查全局对象是否包含document
属性。如果是这样,它会立即初始化,使浏览器内的 CommonJS 环境愉快。如果没有,它 returns 一个函数,可用于稍后初始化 jQuery。稍后可以在伪造的 window 上调用此函数,使用 jsdom.
之类的东西创建
What is the use of the noGlobal
variable?
这里使用了noGlobal
变量。
// Expose jQuery and $ identifiers, even in
// AMD (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
// and CommonJS for browser emulators (#13566)
if ( typeof noGlobal === strundefined ) {
window.jQuery = window.$ = jQuery;
}
本质上,如果 noGlobal
是 undefined
,jQuery 将把自己添加到全局 window
对象中。唯一不会这样做的情况是,如果它由 CommonJS 加载器加载,在全局对象上带有 document
属性,例如 Browserify 或 Webpack。下面的调用是 noGlobal
不是 undefined
.
的地方
factory( global, true )
Where is the factory
actually set up and what is its type?
factory
变量是一个function
,在这里声明:
function( window, noGlobal ) {
这是传递给IIFE的第二个参数。
Why can the factory
argument get called with one argument and with two as well?
因为JavaScript.
在JavaScript中,没有要求匹配函数声明的参数数量。任何省略的参数都具有值 undefined
.
What is the global
argument supposed to contain? (I wish there were a type like in c++...)
它应该包含 JavaScript 环境的全局对象。在浏览器中,这个对象被称为 window
,而在 Node 中,这个对象被称为 global
。在这两种环境中,在全局范围内使用 this
将解析为全局对象,无论它的全局名称是什么。
但是,由于某些第 3 方包装器可以更改 jQuery 初始化的范围,jQuery 将首先检查 window
对象是否可用并使用它如果是。如果不使用,默认使用this
.
typeof window !== "undefined" ? window : this
one more question: where is the w argument coming from?
当全局对象不包含 document
时,它 returns 接受一个参数 w
的函数。该对象将是一个类似于 window
的对象,带有 document
,可以用类似 jsdom.
的东西创建
我正在尝试了解 jQuery 是如何自我设置的。
在开头jQuery自动调用一个函数,导出一个模块。
设置如何工作?
这里有一些更详细的子问题,可以回答更一般的问题:
- 在
module.exports
递归调用function(w)
有什么用? noGlobal
变量有什么用?factory
实际设置在哪里,它的类型是什么?- 为什么
factory
参数可以用一个参数调用,也可以用两个参数调用? global
参数应该包含什么? (我希望有一个类似于 c++ 的类型...)
(function( global, factory ) {
if ( typeof module === "object" && typeof module.exports === "object" ) {
// For CommonJS and CommonJS-like environments where a proper `window`
// is present, execute the factory and get jQuery.
// For environments that do not have a `window` with a `document`
// (such as Node.js), expose a factory as module.exports.
// This accentuates the need for the creation of a real `window`.
// e.g. var jQuery = require("jquery")(window);
// See ticket #14549 for more info.
module.exports = global.document ?
factory( global, true ) :
function( w ) {
if ( !w.document ) {
throw new Error( "jQuery requires a window with a document" );
}
return factory( w );
};
} else {
factory( global );
}
// Pass this if window is not defined yet
}(typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
What is the use of the recursive call to
function(w)
atmodule.exports
?
这不是递归调用,更像是一个延迟初始化函数。在某些 CommonJS 环境中,如 Node.JS,全局对象没有 document
属性,而其他环境,如 Browserify 和 Webpack 则有。
jQuery需要document
属性来初始化,所以它首先检查全局对象是否包含document
属性。如果是这样,它会立即初始化,使浏览器内的 CommonJS 环境愉快。如果没有,它 returns 一个函数,可用于稍后初始化 jQuery。稍后可以在伪造的 window 上调用此函数,使用 jsdom.
What is the use of the
noGlobal
variable?
这里使用了noGlobal
变量。
// Expose jQuery and $ identifiers, even in
// AMD (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
// and CommonJS for browser emulators (#13566)
if ( typeof noGlobal === strundefined ) {
window.jQuery = window.$ = jQuery;
}
本质上,如果 noGlobal
是 undefined
,jQuery 将把自己添加到全局 window
对象中。唯一不会这样做的情况是,如果它由 CommonJS 加载器加载,在全局对象上带有 document
属性,例如 Browserify 或 Webpack。下面的调用是 noGlobal
不是 undefined
.
factory( global, true )
Where is the
factory
actually set up and what is its type?
factory
变量是一个function
,在这里声明:
function( window, noGlobal ) {
这是传递给IIFE的第二个参数。
Why can the
factory
argument get called with one argument and with two as well?
因为JavaScript.
在JavaScript中,没有要求匹配函数声明的参数数量。任何省略的参数都具有值 undefined
.
What is the
global
argument supposed to contain? (I wish there were a type like in c++...)
它应该包含 JavaScript 环境的全局对象。在浏览器中,这个对象被称为 window
,而在 Node 中,这个对象被称为 global
。在这两种环境中,在全局范围内使用 this
将解析为全局对象,无论它的全局名称是什么。
但是,由于某些第 3 方包装器可以更改 jQuery 初始化的范围,jQuery 将首先检查 window
对象是否可用并使用它如果是。如果不使用,默认使用this
.
typeof window !== "undefined" ? window : this
one more question: where is the w argument coming from?
当全局对象不包含 document
时,它 returns 接受一个参数 w
的函数。该对象将是一个类似于 window
的对象,带有 document
,可以用类似 jsdom.