加载Angular JS组件报typeerror-angular-lowercase-is-not-a-function错误如何解决
错误原因
angular.lowercase是AngularJS 1.x内置的全局工具方法,Angular 2+(包括你使用的Angular 9)已完全移除了这类全局挂载的工具API。混合项目中出现该报错,本质是需要运行的AngularJS代码尝试调用已经被移除/覆盖的angular.lowercase方法导致的。
排查步骤
- 定位报错代码位置:通过浏览器控制台的错误调用栈,找到直接调用
angular.lowercase的代码所属文件,确认是自研业务代码,还是第三方AngularJS组件/依赖库发起的调用。 - 校验AngularJS版本:AngularJS 1.7.x及以上版本也已官方弃用
angular.lowercase/angular.uppercase系列方法,如果你的项目中AngularJS版本>=1.7,也可能是AngularJS自身版本迭代带来的兼容问题。 - 检查全局对象挂载逻辑:确认
@angular/upgrade升级模块的初始化顺序,排查是否存在Angular 9启动逻辑覆盖了AngularJS挂载的全局angular对象方法的情况。
解决方案
场景1:调用方为自研业务代码
直接替换所有angular.lowercase(参数)的写法为原生JS字符串方法参数.toLowerCase()即可,对应angular.uppercase可替换为参数.toUpperCase(),无需额外引入依赖。
场景2:调用方为不可修改的第三方AngularJS依赖
- 方案1:手动补全全局polyfill。在AngularJS初始化完成后、所有业务代码/第三方依赖加载前,执行以下代码:
// 优先取项目中引入的angular对象,没有则取window上挂载的全局对象 const ng = window.angular || require('angular'); if (!ng.lowercase) { ng.lowercase = (str) => typeof str === 'string' ? str.toLowerCase() : str; } // 同步补全uppercase避免后续同类报错 if (!ng.uppercase) { ng.uppercase = (str) => typeof str === 'string' ? str.toUpperCase() : str; }
- 方案2:升级对应第三方依赖到兼容高版本Angular/AngularJS的版本,从依赖层面解决兼容问题。
- 方案3:如果项目中AngularJS版本低于1.7,可临时锁定AngularJS的依赖版本到1.6.x,该版本仍保留
lowercase系列原生方法。
注意事项
- 补全polyfill时必须严格控制执行顺序,确保polyfill代码在AngularJS挂载到全局后、所有调用
angular.lowercase的代码运行前执行,否则会出现polyfill不生效的问题。 - 自研业务代码优先选择原生字符串方法替代,长期来看可以减少对AngularJS全局API的依赖,方便后续完全迁移到Angular 9+版本。
内容的提问来源于stack exchange,提问作者Balaji Rajendran
相关产品推荐
相关产品推荐

