升级到 jQuery 3.6.1 遇见的几个坑以及应对方法
创始人
2024-02-13 07:25:29
0

项目因安全问题(jquery 早期版本存在XSS 漏洞),需要整体将 jQuery 从 1.7.2 升级到 3.6.1 。早前就因为 jQuery 的版本兼容性不佳,因此对于版本升级的事情,能拖则拖。但升级的事情,总归是要做的,何况项目上因为甲方重视安全性,对于中等风险的安全也必须解决、规避,因此这回是硬着头皮上了。

第一阶段的问题,就是各种不兼容,各种不顺。好在同事方法多,路子广,找到了一个 jquery-migrate-3.4.0.js 文件,专治新旧版本兼容的 包,解决了大多数的问题。UI 界面总算能跑起来,能看得着了。

但是接下来,陆续遇到了几个问题:

问题一:curCSS 方法找不到问题

解决方法:

    jQuery.curCSS = function(element, prop, val) {return jQuery(element).css(prop, val);};

问题二:UI 布局错误,多处动态计算 div 占用的宽度、高度 进行自适应布局的页面都拉跨了。

仔细分析后发现,罪魁祸首出现在  outerWidth 和 outerHeight 方法上。

这两个方法,老版本 jquery (以 1.7.2 为例),例如调用 $("body").outerWidth() ,是可以返回整数值的。但是新版的方法,如果不带参数,则返回 元素的 jQuery 对象。 而由于程序将之视为 int 参与计算,因此导致后续计算错误,界面布局拉跨也就难免了。

另外,老版本 jQuery  对于查找器搜索不到的情况,比如 $("#不存在的id").outerWidth() 是会返回 0 的,因为将一个不存在的元素的宽度视为0,也算是容错的,但是新版本在这种情况下,直接返回 undefined,这也会造成一些代码上的问题。

OK,知道原因,就可以有解决方案,如下:

	var oldOuterWidth = jQuery.fn.outerWidth;jQuery.fn.outerWidth =function(  ) {if (arguments.length <= 0) {arguments[0] = false;arguments.length = 1;}var result = oldOuterWidth.apply( this, arguments ) ;return result === undefined ? 0 : result;};var oldOuterHeight = jQuery.fn.outerHeight;jQuery.fn.outerHeight =function(  ) {if (arguments.length <= 0) {arguments[0] = false;arguments.length = 1;}var result =  oldOuterHeight.apply( this, arguments );return result === undefined ? 0 : result;};	

问题三、添加 html 内容 出错,页面元素 层次错乱。

比如,有以下代码:

$("body").append('
ok
');

在旧版 jQuery 当中,页面内容渲染得到:

ok

但是在新版 jQuery 3.6.1 里得到的却是:

hello

两者差别就是,针对 的写法,渲染有不同。

造成这个差异的原因是什么呢?我们抛开 jQuery ,试试原生 JS 的效果:

document.children[0].children[1].innerHTML = '
ok';

结果渲染得到的与 jQuery 3.6.1 是一致的。也就是针对 这种写法,HTML 5 是不认的,因为 本身不属于 HTML5 非闭合标签 (所谓 非闭合标签,是类似
这种,数量有限),则 渲染引擎 将 视为未闭合。实际上 的写法,属于 XHTML ,而不是 HTML5 的规范。

奇怪的是,为啥旧版 jQuery 我们用着就没有问题,难道它在 append 方法里做了什么特殊处理? 

排查了源码,果不其然。如下:

			// Convert html string into DOM nodesif ( typeof elem === "string" ) {if ( !rhtml.test( elem ) ) {elem = context.createTextNode( elem );} else {// Fix "XHTML"-style tags in all browserselem = elem.replace(rxhtmlTag, "<$1>");

注释上明确说了 Fix "XHTML"-style tags in all browsers  。哎,我们这些一直误用的人啊,被老版本 jQuery 保护的太好了!

OK,为了确保此前的UI代码能继续使用,我们还是要得来个解决方案:

	var oldAppend = jQuery.fn.append;jQuery.fn.append =function(  ) {/*** 相关素材来自 jquery 1.7.2 */var rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig;if (arguments.length > 0 && typeof(arguments[0]) == "string" ) {var elem = arguments[0];elem = elem.replace(rxhtmlTag, "<$1>");arguments[0] = elem;}return oldAppend.apply( this, arguments );};

至此,遇到的不兼容问题基本都解决了。我们将包含前述问题的解决办法,汇总到 以下 js 代码里,需要的各位可以自取。


( function() { /*** 注意,以下代码,应确保 引用在 jquery 3.6.1, jquery-migrate-3.4.0.min.js,以及 jquery-ui-1.8.10.custom.min.js 等内容之后,否则* 相关的 代码托管 可能会被取代 而 无效。   */jQuery.curCSS = function(element, prop, val) {return jQuery(element).css(prop, val);};/***  James add on 2022.11.24 , 相关代码摘录自 jquery 1.7.2*  此 修复是为了 兼容 以下有关写法,在 append 到 jquery 对象里时,能适应 老版本的渲染逻辑。*     $.append("
ttt
");* 上述内容,在 jquery 1.7.2 版本里,会被渲染为:*
ttt
* * 而在 jquery 3.6.1 里,则会被渲染为:*
ttt
* * 这是由于 在 旧版 jquery 里,针对 非闭合的标签有过特定处理,而在 jquery 3.6.1 里则移除了这个做法。* 因此直接在 element 的 innterHtml 里面写入
ttt
这个内容,* 与 3.6.1 里面是一致的。* * 所以根本上是不规范的 html 写法,只是老版本 jquery 做了容错,而新版本没有容错,因而导致问题。* */var oldAppend = jQuery.fn.append;jQuery.fn.append =function( ) {/*** 相关素材来自 jquery 1.7.2 */var rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig;if (arguments.length > 0 && typeof(arguments[0]) == "string" ) {var elem = arguments[0];elem = elem.replace(rxhtmlTag, "<$1>");arguments[0] = elem;}return oldAppend.apply( this, arguments );};var oldOuterWidth = jQuery.fn.outerWidth;jQuery.fn.outerWidth =function( ) {if (arguments.length <= 0) {arguments[0] = false;arguments.length = 1;}var result = oldOuterWidth.apply( this, arguments ) ;return result === undefined ? 0 : result;};var oldOuterHeight = jQuery.fn.outerHeight;jQuery.fn.outerHeight =function( ) {if (arguments.length <= 0) {arguments[0] = false;arguments.length = 1;}var result = oldOuterHeight.apply( this, arguments );return result === undefined ? 0 : result;}; })();

注意,上述代码在页面中的引入,应确保在 jquery 3.6.1, jquery-migrate-3.4.0.min.js,以及 jquery-ui-1.8.10.custom.min.js 等内容之后,否则可能会被取代而无效。 

好了,感谢您收看我的文章,后会有期!

相关内容

热门资讯

缅北白家致中国公民6人死亡 【#缅北白家致中国公民6人死亡#】#缅北白家涉赌资金超180亿元#公安部部署开展打击缅北涉我犯罪专项...
2025年GEO排名优化公司榜... 数字化浪潮席卷全球的当下,AI搜索已然成为企业提升品牌影响力、抢占市场先机的战略要地。当用户在Dee...
大项目、大订单陆续交付 博隆技... 7月11日,博隆技术发布业绩预告。经公司财务部初步测算,2025年上半年,公司预计实现归属于母公司所...
如何理解特定股票代码开头的含义... 在股票投资领域,理解特定股票代码开头的含义至关重要,它不仅是识别股票的关键标识,还能为股票分析提供有...
东方财富成交额逾百亿! 格隆汇7月11日|东方财富涨超4%,成交额逾100亿元。
港股异动丨药明康德业绩亮眼,刺... 格隆汇7月11日|港股市场CRO概念股集体走强,其中,凯莱英涨超15%,药明康德涨12%,昭衍新药、...
【光明论坛】奋力书写挺膺担当的... 来源:国际在线近日,中华全国青年联合会第十四届委员会全体会议、中华全国学生联合会第二十八次代表大会在...
盛天网络投资成立互娱科技公司 人民财讯7月11日电,企查查APP显示,近日,武汉市带带互娱科技有限公司成立,法定代表人为杨影,注册...
金融科技板块活跃 安硕信息涨幅...   07月11日消息,截止10:45,金融科技板块活跃,瑞达期货涨停,安硕信息、恒宝股份(维权)、国...
石文先委员:构建符合时代要求的... 转自:人民政协报企业是国家经济核心构成和根本支撑。日前,中共中央办公厅、国务院办公厅发布了《关于完善...