作为其持续基础设施更新的一部分，jQuery 基础设施团队正在进行配置和部署更改以解决一些用户报告的间歇性中断。该问题是由于错误的 IP 允许列表导致的，影响了从某些 IP 地址下载 jQuery 项目资产的用户。

预计该问题将在未来几周内解决。在此期间，用户可以通过下载并提供他们需要的文件来缓解该问题。

CDN 迁移是该项目今年正在进行的基础设施改进项目的一部分。基础设施团队计划在今年夏天晚些时候提供这些改进的完整概述，这些改进将有助于支持 jQuery 及其相关项目的长期维护。

jQuery 仍然是一个广泛使用的开源项目，拥有活跃的维护者。虽然许多网站在本地托管 jQuery，但其他网站依赖 jQuery CDN 按需提供库。平均而言，jQuery CDN 每月提供超过 2 PB 的代码。该项目托管在 OpenJS Foundation，这是一个供应商中立的组织，致力于发展和维护 JavaScript 和 Web 生态系统。

jQuery 有了一个新版本！距离我们上次发布已经有一段时间了，但我们预计这将是 3.x 分支的最后一个次要版本，然后我们将进入 jQuery 4.0 的大修。但在我们进入 4.0 之前，我们很高兴分享 jQuery 3.4.0 中包含的错误修复和改进。以下是一些亮点

.width 和 .height 的性能改进

在获取和设置尺寸时，某些情况下会导致布局抖动，这基本上意味着浏览器计算布局的次数比必要时多。我们在除 IE 之外的所有浏览器中修复了这个问题，在 IE 中无法避免。

nonce 和 nomodule 支持

为了支持通过 .html 和 .append 等方法添加脚本元素，jQuery 会将它们分开，并将新的脚本标签附加到加载和执行远程内容。在此过程中，nonce 和 nomodule 等属性被忽略，但 jQuery 3.4.0 现在会保留它们。

单选按钮：事件处理程序中的预期状态

我们已经修复了复选框的相同问题，但意外地遗漏了单选按钮输入。在以下示例中，第一次单击元素时会记录 true。我们修复了它，以便在执行事件处理程序之前更新 checked 属性。

示例

var $radios = jQuery(".example");
var $firstRadio = $radios.first();
var firstCheckedState = $firstRadio.prop("checked");
$radio.on("click", function() {
  // true in <3.4.0
  console.log($firstRadio.prop("checked") === firstCheckedState);
});
$radios.eq(1).click();

次要漏洞修复：Object.prototype 污染

jQuery 3.4.0 包含对使用 jQuery.extend(true, {}, ...) 时的某些意外行为的修复。如果未经清理的源对象包含一个可枚举的 __proto__ 属性，它可能会扩展原生 Object.prototype。此修复程序包含在 jQuery 3.4.0 中，但 补丁差异 存在于修补之前的 jQuery 版本。

示例

jQuery.extend(true, {},
  JSON.parse('{"__proto__": {"test": true}}')
);
console.log( "test" in {} ); // true

请注意，虽然 jQuery 尽最大努力保护用户免受安全漏洞的影响，但 jQuery 是一个 DOM 操作库，它通常会按照你的指示执行操作。在这种情况下，行为可能是意外的，因此 jQuery.extend 将不再写入任何名为 __proto__ 的属性。但是，此类保护措施并不是良好安全实践（如用户输入清理）的替代品。

弃用位置选择器和 Sizzle 的日落

jQuery 的基本 API 是选择一些东西，然后对所选择的东西进行操作。jQuery 中的选择器引擎 Sizzle 处理前半部分。它一直是一个快速高效的小引擎，为 querySelectorAll 等原生选择器 API 以及其他原生 JavaScript 和 CSS 选择器铺平了道路。现在，由于许多这些选择器已经进入了现代浏览器，我们几乎要向 Sizzle 说再见了。但为了在 jQuery 4.0 中删除 Sizzle，我们还需要删除我们所说的位置选择器，它们是非标准选择器。

具体来说，jQuery 3.4.0 弃用了 :first、:last、:eq、:even、:odd、:lt、:gt 和 :nth。当我们删除 Sizzle 时，我们将用一个围绕 querySelectorAll 的小型包装器来替换它，并且在没有更大的选择器引擎的情况下几乎不可能重新实现这些选择器。

我们认为这种权衡是值得的。请记住，我们仍然支持位置方法，例如 .first、.last 和 .eq。任何可以用位置选择器做的事情，都可以用位置方法来代替。它们执行起来也更好。

升级

如果从 jQuery 3.0+ 升级，应该不会出现兼容性问题。如果你还没有升级到 jQuery 3+，请查看 3.0 升级指南。使用 jQuery Migrate 3.0 插件 可以帮助你识别代码中的兼容性问题。

请尝试使用这个新版本，并 告知我们你遇到的任何问题。

下载

您可以从 jQuery CDN 获取文件，或者直接链接到它们。

https://code.jqueryjs.cn/jquery-3.4.0.js

https://code.jqueryjs.cn/jquery-3.4.0.min.js

您也可以从 npm 获取此版本。

npm install jquery@3.4.0

精简版

有时您不需要 ajax，或者您更喜欢使用专注于 ajax 请求的众多独立库之一。而且，通常使用 CSS 和类操作来进行 web 动画更加简单。除了包含 ajax 和效果模块的 jQuery 正式版本之外，我们还发布了一个“精简版”，它排除了这些模块。如今，jQuery 的大小很少会成为负载性能的困扰，但精简版比正式版本压缩后小约 6k 字节。这些文件也可以在 npm 包和 CDN 上找到。

https://code.jqueryjs.cn/jquery-3.4.0.slim.js

https://code.jqueryjs.cn/jquery-3.4.0.slim.min.js

这些更新已经作为 npm 和 Bower 上的当前版本提供。有关获取 jQuery 的所有方法的信息，请访问https://jqueryjs.cn/download/。公共 CDN 会在今天收到它们的副本，请给他们几天时间来发布文件。如果您急于快速开始，请使用我们 CDN 上的文件，直到它们有机会更新。

感谢

感谢所有参与此版本发布的人，包括提交补丁、报告错误或进行测试的人，包括 abnud1、Jason Bedard、buddh4、Kris Borchers、Andrei Fangli、Oleg Gaidarenko、Richard Gibson、Michal Golebiowski-Owczarek、Marja Hölttä、Dave Methvin、Ed S、Luis Emilio Velasco Sanchez、Saptak Sengupta、tmybr11、Bert Zhang 以及整个 jQuery 团队。

变更日志

GitHub 变更日志： 3.4.0 中修复的问题 | 所有更改

Ajax

• 在使用脚本传输时允许自定义属性 (#3028，1f4375a3)
• 修复 IE11 的 getResponseHeader(key) (#3403，e0d94115)

核心

• 使用 isAttached 检查元素的附加 (662083ed)
• 对 jQuery.extend / jQuery.fn.extend 的微小效率修复 (#4246) (#4245，4ffb1df8)
• 在 DOM 操作中保留带有 src 属性的脚本上的 CSP nonce (#4323，00504037)
• 在 DOM 操作中保留脚本上的 CSP nonce (#3541，c7c2855e)
• 支持通过 jQuery.globalEval 传递 nonce (#4278，5bdc85b8)
• 在附加检查中识别 Shadow DOM (#3504，9b77def5)
• 防止 $.extend( true, … ) 的 Object.prototype 污染 (753d591a)

CSS

• 确保驼峰式和短横线分隔式名称不会为 CSS 变量折叠 (f8c1e902)
• 避免填充 jQuery.cssProps (#3986，2b5f5d5e)
• 使用非默认缩放正确检测滚动框支持 (#4029，821bf343)
• 不要为 CSS 变量自动添加 “px” (#4064) (#4063，75b77b48)
• 跳过非元素属性的动画的 px 添加逻辑 (f5e36bd8)
• 除非必要，否则避免在 width/height 获取器中强制执行重排 (#4322，a0abd15b)
• 除非必要，否则不要在 width/height cssHook 中读取 styles.position (#4185，354f6036)
• 不要为可能无单位的 CSS 网格属性自动添加 “px” (#4007，f997241f)

尺寸

• 修复 SVG 上的 outerWidth 计算 (#3964，e743cbd2)
• 在设置 width/height 时避免获取 boxSizing - 这在某些情况下可以避免强制执行重排 (#3991，73d7e625)
• 在 IE 中回退到 offsetWidth/Height 以获得边框框 (#4102，315199c1)

事件

• 防止 leverageNative 双重触发 focusin (fe5f04de)
• 向 Event 对象添加 “code” 属性 (#3978，899c56f6)
• 利用 focus/blur/click 的原生事件；传播其他数据 (#1741，#3423，#3751，#4139，669f720e)
• 在 DOM 操作中尊重脚本 nomodule 属性 (#4281，e4de8b46)
• 将 _evalUrl jQuery.ajax 调用还原为 dataType: script (13de7c9e)
• 仅评估 HTTP 成功脚本 src (#4126，c2026b11)

操作

• 正确检测具有单字符名称的 HTML 元素 (#4124，979809c5)

其他

• 添加 lockbot 的配置 (2348f399)
• 更新许可证序言/尾声以安抚 Github 检查器 (29e76e25)

README

• 将 gitter 徽章添加到 README.md (7869f83d)
• 添加 FOSSA 许可证扫描状态徽章 (45f08588)

选择器

• 将 Sizzle 从 2.3.3 更新到 2.3.4 (#1756，#4170，#4249，d940bc06)

序列化

• jQuery.param：当给定 null/undefined 时返回空字符串 (#2633，0645099e)

遍历

• $.fn.contents() 支持对象 (#4045，0ba8e38d)

内部

• uglify 及其选项的季节性更新 (09684ba3)
• 删除不必要的 ESLint 异常 (dc05f3c1)
• 在 jsdom 中运行基本测试套件 (0ec25abb)
• 移除手动 QUnit fixture 重置 (84b6a0be)
• 使 Promises/A+ 测试使用点报告器而不是默认报告器 (ca9356ec)
• 将 QUnit 从 1.23.1 更新到 2.9.2 (6ced2639)
• 在 Node.js 10 上运行 Karma 浏览器测试，而不是 Node.js 8 (16ad9889)
• 更新 jsdom；将使用 Symbol polyfill 的测试迁移到 iframe 测试 (9cb124ed)
• 从 ESLint 配置中移除过时的全局变量 (c10945d0)
• 更新大多数依赖项 (8751e9ef)
• 更新测试代码以兼容 QUnit 2.x (#4297) (c3498187)
• 建议在 JS Bin 或 CodePen 上创建测试用例，放弃 JSFiddle (da44ff39)

很久以前，Mike Taylor 指出 jQuery CDN 有一个缩减版 jQuery 1.9.1，其映射文件引用不正确。基本上，它引用了 jQuery 1.11.1 的映射文件，而这完全是错误的。如果您尝试调试使用缩减版 jQuery 1.9.1 文件的网站，开发工具会非常困惑，让本已困难的工作变得更加困难。

您可能会认为我们可以简单地编辑 https://code.jqueryjs.cn/jquery-1.9.1.min.js 文件以指向正确的映射文件，该文件确实存在，名为 https://code.jqueryjs.cn/jquery-1.9.1.min.map。这样做至少有两个问题。第一个问题是该文件在互联网上被大量缓存，因为多年来一直认为它在发布后永远不会改变。即使我们编辑了文件，JavaScript 和映射文件也可能永远不会在它们被使用的时候实际更新。

第二个问题更为严重。我们一直在倡导开发者使用 脚本的 integrity 属性 来确保您包含的文件自您最初编写脚本标签后没有被修改。如果我们修改文件的内容，该属性将不正确，页面将不再包含该文件。这很可能会完全破坏页面！考虑到 jQuery 1.9.1 的历史悠久，包含此文件的许多页面可能没有得到积极维护。因此，我们不能认真考虑以任何方式更改 JavaScript 文件，甚至是一字节也不行。

最不具破坏性的选择是移除 jQuery 1.9.1 缩减版文件引用的 jquery.min.map 文件。它 *不会* 影响 jQuery 是否能为网站访客正确运行。它只会禁用源映射。由于在 CDN 和整个互联网上包含 sourceMappingURL 映射引用的这些弊端，我们不再包含它。

如果您需要调试使用这些缩减版文件之一的网站，可以手动在 Chrome 中关联映射文件。打开缩减版源文件，右键单击缩减版源代码区域，然后选择“添加源映射…”。

jQuery CDN 中不正确的 jquery.min.map 文件已被移除。我们预计移除此文件不会有任何明显的变化，除了恢复对使用 jQuery 1.9.1 的网站进行调试的正常状态之外。jQuery 1.11.1 缩减版文件不引用其映射文件，因此它将继续正常工作，您可以关联映射文件，如上所述。

由于 CDN 和整个互联网上的缓存非常积极，您可能还会在一段时间内看到此映射文件。如果您发现您认为与缺少 jquery.min.map 文件相关的某些异常行为，您可以 在 CDN 问题跟踪器上创建一个工单.

我们在 jQuery 3.3.0 的发布中遇到了一个问题，因此我们立即发布了另一个标签。代码本身是相同的，但是由于 npm 5+ 版本的新行为，我们的发布依赖项（仅在发布期间使用）被添加到 jQuery 包本身的依赖项中。

如果从 npm 或 GitHub 安装，现在推荐使用 jQuery 3.3.1。如果在任何 CDN 上使用 jQuery，构建的文件只有版本号不同。

我们对由此造成的不便表示歉意，并且已经更新了我们的发布脚本以解决此问题。

请查看 jQuery 3.3.0 博客文章，了解此版本中所有相关的代码更改。

下载

您可以从 jQuery CDN 获取文件，或者直接链接到它们。

https://code.jqueryjs.cn/jquery-3.3.1.js

https://code.jqueryjs.cn/jquery-3.3.1.min.js

您也可以从 npm 获取此版本。

npm install jquery@3.3.1

精简版

有时候您不需要 ajax，或者您更喜欢使用专注于 ajax 请求的众多独立库之一。而且，对于所有网页动画，使用 CSS 和类操作的组合通常更简单。除了包含 ajax 和效果模块的 jQuery 正式版本之外，我们还发布了一个“精简”版本，该版本排除了这些模块。如今，jQuery 的大小很少会成为加载性能问题，但精简版构建的大小比正式版本缩减了约 6k gzip 字节 - 24k 对 30k。这些文件也在 npm 包和 CDN 上可用。

https://code.jqueryjs.cn/jquery-3.3.1.slim.js
https://code.jqueryjs.cn/jquery-3.3.1.slim.min.js

这些更新已经作为 npm 和 Bower 上的当前版本提供。有关获取 jQuery 的所有方法的信息，请访问https://jqueryjs.cn/download/。公共 CDN 会在今天收到它们的副本，请给他们几天时间来发布文件。如果您急于快速开始，请使用我们 CDN 上的文件，直到它们有机会更新。

距离上次 jQuery 版本发布已经有一段时间了，但核心团队并没有闲着。我们为您带来了一个全新的次要版本，它甚至还带有一个新功能！

.addClass()、.removeClass() 和 .toggleClass() 方法现在接受一个 **数组** 类。

jQuery(elem).addClass([
   'dave', 'michał', 
   'oleg', 'richard', 
   'jason', 'timmy'
]);

总的来说，jQuery 并不打算添加任何新功能。我们更倾向于关注我们可以移除什么，而不是我们可以添加什么。但当我们看到这个功能请求时，我们想知道为什么它之前没有被添加。

如果从 jQuery 3.0+ 升级，应该不会出现兼容性问题。如果你还没有升级到 jQuery 3+，请查看 3.0 升级指南。使用 jQuery Migrate 3.0 插件 可以帮助你识别代码中的兼容性问题。

请尝试使用这个新版本，并 告知我们你遇到的任何问题。

弃用

我们在本次版本中修剪了一些玫瑰、百合和向日葵。其中一些闻起来比其他一些更香，但将它们放在一起，您就得到了一束美丽的... *废弃花*。

这些函数随着时间的推移已经失去了部分实用性，被认为不如可用的替代方案更受欢迎，或者从一开始就旨在用于内部使用。虽然这些函数中的大多数将在 jQuery 4.0 中被移除，但值得注意的是，我们并不认为废弃一个方法就意味着它将被移除；这意味着我们鼓励使用替代方案。例如，像 .click() 这样的事件别名可能永远不会被移除。

• jQuery.now (#2959，909e0c99)
• jQuery.isWindow (#3629，c18d6085)
• jQuery.camelCase(#3384，64a28928)
• jQuery.proxy (不打算移除) (#2958，3a8e4474)
• jQuery.type (#3605，1ea092a5)
• jQuery.isNumeric (#2960，c4494d4a)
• jQuery.isFunction (#3609，3d732cca)
• 事件别名 (#3214，022b69a4)

命令行测试

出色的 Timo Tijhof 使得 在命令行上运行所有 jQuery 测试 成为可能，使用 grunt 和 karma。这是我们一直想要做的事情，但它因为我们需要 php 服务器来运行 ajax 测试而变得复杂。感谢 Timo 让它成为现实！

注意：jQuery 不再在 PhantomJS 1.x 上运行任何测试。

下载

您可以从 jQuery CDN 获取文件，或者直接链接到它们。

https://code.jqueryjs.cn/jquery-3.3.0.js

https://code.jqueryjs.cn/jquery-3.3.0.min.js

您也可以从 npm 获取此版本。

npm install jquery@3.3.0

精简版

有时候您不需要 ajax，或者您更喜欢使用专注于 ajax 请求的众多独立库之一。而且，对于所有网页动画，使用 CSS 和类操作的组合通常更简单。除了包含 ajax 和效果模块的 jQuery 正式版本之外，我们还发布了一个“精简”版本，该版本排除了这些模块。如今，jQuery 的大小很少会成为加载性能问题，但精简版构建的大小比正式版本缩减了约 6k gzip 字节 - 24k 对 30k。这些文件也在 npm 包和 CDN 上可用。

https://code.jqueryjs.cn/jquery-3.3.0.slim.js
https://code.jqueryjs.cn/jquery-3.3.0.slim.min.js

这些更新已经作为 npm 和 Bower 上的当前版本提供。有关获取 jQuery 的所有方法的信息，请访问https://jqueryjs.cn/download/。公共 CDN 会在今天收到它们的副本，请给他们几天时间来发布文件。如果您急于快速开始，请使用我们 CDN 上的文件，直到它们有机会更新。

感谢

感谢所有参与本次版本发布的人，包括通过提交补丁、报告错误或测试，包括 Andreas Solledar、Basil Belokon、Boom Lee、“CDAGaming”、Dave Methvin、Erik Lax、Henry Zhu、Jason Bedard、Jordan Beland、Matan Kotler-Berkowitz、Michał Gołębiowski-Owczarek、Nilton Cesar、Pierre Spring、Richard Gibson、Saptak Sengupta、Shashanka Nataraj、Steve Mao、Timo Tijhof、Faisal Irfan Yar Khan 以及整个 jQuery 团队。

 

变更日志

GitHub 变更日志： 在 3.3.0 中修复的问题 | 所有更改

Ajax

• 为所有请求添加一个 ontimeout 处理程序 (#3586，262acc6f)
• 不要在无实体主体请求上处理非字符串数据属性 (#3438，d7237896)

属性

• 功能：允许在 add/remove/toggleClass 中使用数组参数 (#3532，80f57f8a)

构建

• 在 Node.js 8 上进行测试，停止在 Node.js 7 上进行测试 (bef46a2a)
• 更新到 Babel 7，使用 for-of 插件而不是 preset-es2015 (90bac40a)
• 移除 package-lock.json，将其添加到 .gitignore (#3792，7037facc)
• 在 Node.js 9 上进行测试 (3e902a81)
• 修复 Android 4.0 中 UglifyJS 输出；更新 uglify (#3743, c9efd11f)

核心

• 弃用 jQuery.now (#2959, 909e0c99)
• 弃用 jQuery.isWindow (#3629, c18d6085)
• 使 camelCase 函数仅供内部使用 (#3384, 64a28928)
• 弃用 jQuery.proxy（不计划移除）(#2958, 3a8e4474)
• 弃用 jQuery.type (#3605, 1ea092a5)
• 弃用 jQuery.isNumeric (#2960, c4494d4a)
• 更新 isFunction 以处理非正常-@@toStringTag 输入 (#3600, #3596, a16339b8)
• 弃用 jQuery.isFunction (#3609, 3d732cca)

CSS

• 从 cssProps 中删除浮点映射 (bbf33428)
• 使用非默认缩放值正确设置支持属性 (#3808, f00a0759)
• 检测更多错误地报告为百分比的 WebKit 样式 (#3777, 94ddf620)
• 在计算之前检索内联样式 (c4598da4)
• 避免来自 CSS 上限的单位转换干扰 (#2144, 692f9d4d)

延迟

• 修复承诺回调的内存泄漏 (#3606, 36389288)

尺寸

• 改进 offsetWidth/offsetHeight 回退 (#3698, #3602, a4957849)
• 在“padding”框中包含滚动边距 (#3589, 80f1c823)
• 对于内联元素回退到 offsetWidth/Height (#3571, 473d2ea7)
• 不要信任非像素计算宽度/高度 (#3611, 3cf1d14c)
• 检测并考虑内容框尺寸处理错误 (#3699, 3fcddd6e)

文档

• 创建 CODE_OF_CONDUCT.md (e84d3bc0)
• 更新指向 stripAndCollapse 的 HTML 规范链接 (#3594) (e1b1b2d7)

事件

• 将事件别名移至弃用 (#3214, 022b69a4)
• 在本地事件处理程序上调用 `stopPropagation()` (#3693, 490db839)

筛选器

• 在 winnow 中使用直接筛选器 (#3272, 4765bb5c)

操作

• 使用 `.children` 选择 tbody 元素 (a88b48ea)
• 添加对具有模块类型脚本的支持 (#3871, 5d3a968e)

偏移量

• 使用正确的偏移量父级；包含所有边框/滚动值 (#3080, #3107, 1d2df772)

支持

• 正确检查 IE9 绝对滚动框处理错误 (#3699, #3730, 20cdf4e7)