将网站从jQuery 1.8.3迁移至1.9.1后出现类型错误求助

我来帮你拆解这两个升级jQuery版本时遇到的常见兼容性问题：

错误原因 #

$.widget并不是jQuery核心库自带的方法，它是jQuery UI Widget Factory提供的功能，用来创建可复用的UI组件。你之前用jQuery 1.8.3时，大概率是和配套的jQuery UI一起引入的，或者用了包含jQuery UI的打包版本；升级到1.9.1后，要么没引入jQuery UI，要么引入的jQuery UI版本和1.9.1不兼容，导致ui.dropdownchecklist.js找不到这个方法。

解决思路 #

• 先确认脚本引入顺序：必须先引入jquery-1.9.1.min.js，再引入与jQuery 1.9.1兼容的jQuery UI版本（推荐jQuery UI 1.10.x系列，这个版本专门适配jQuery 1.9.x），最后才引入ui.dropdownchecklist.js。
• 检查ui.dropdownchecklist.js的版本：如果这个插件是比较旧的版本，可能需要找它适配jQuery 1.9+的更新版；如果找不到，可以尝试修改插件代码里依赖$.widget的初始化部分，确保它能正确调用jQuery UI的方法。

错误原因 #

这个错误主要有两种可能：

1. 脚本引入顺序错误：比如main.js在jquery-1.9.1.min.js之前就加载了，导致代码调用ready().promise()时，jQuery还没完成初始化，自然找不到对应的方法。
2. API兼容性问题：jQuery 1.9.x对部分旧API做了调整，ready()方法不再返回支持.promise()调用的对象，而你的代码（或者依赖的插件）还在使用这个旧写法。

解决思路 #

• 先核对脚本加载顺序：把jquery-1.9.1.min.js放在所有依赖它的脚本（比如main.js）前面引入，确保jQuery先初始化完成。
• 引入jQuery Migrate 1.2.x：这个工具专门用来处理从jQuery 1.8到1.9的过渡，会恢复一些已废弃的API，包括让ready()方法支持.promise()调用，帮你快速兼容旧代码。
• 直接修改代码：如果是你自己写的代码调用了$(document).ready().promise()，可以改成标准写法，比如用$.when($(document)).done(function() { /* 你的代码 */ })，或者直接用$(document).ready(function() { ... })来替代依赖promise的逻辑。

内容的提问来源于stack exchange，提问作者sinaxtis