Fix Pseudo Modules

作者 UI52b8c4a944e39无许可证收录于 2026年10月8日更新于 2026年10月8日

Fix pseudo module and implicit global issues that UI5 linter reports but cannot auto-fix. Use this skill when linter outputs: - `no-pseudo-modules` with messages about deprecated enum or DataType pseudo module access - `no-implicit-globals` with messages about module not exported by library or OData globals Trigger on: direct enum imports (sap/ui/core/BarColor), direct DataType imports (sap/ui/core/CSSSize), library.EnumName access, odata.compare/fillUriTemplate/uriEncode in bindings. Provides guidance on proper module imports for enums, DataTypes, and OData expression addons.

仅含说明Software Development
AI 生成的概览

指导修复 UI5 检查器报告的伪模块与隐式全局错误，通过修正模块导入方式解决。

功能
该技能说明如何解决 UI5 检查器无法自动修复的问题：已弃用的枚举与 DataType 伪模块访问、通过库导出访问但库并未导出的模块，以及隐式 OData 全局符号。它把每条检查规则和消息模式对应到修复策略，并给出前后对比代码：从库模块导入枚举与 DataType、直接导入类、为 odata.* 函数导入 ODataExpressionAddons。它还涵盖 XML 视图，需在其中添加 core:require 条目，并列出常见伪模块及其对应的库模块。
适用场景
当 UI5 检查器输出 no-pseudo-modules（枚举或 DataType 伪模块访问）或 no-implicit-globals（模块未被库导出、OData 内置全局符号）时使用。适用于采用这些写法的 JavaScript 控制器和 XML 视图。
运行要求
不附带任何脚本或工具，仅为指导性说明。前提是 UI5 检查器已输出相关规则结果，且项目使用 UI5 模块加载方式（sap.ui.define、XML 视图）。

Fix Pseudo Modules and Implicit Globals

This skill fixes pseudo module access and implicit global issues that the UI5 linter detects but cannot auto-fix because they require understanding proper module import patterns.

Linter Rules Handled

Rule IDMessage PatternThis Skill's Action
no-pseudo-modulesDeprecated access of enum pseudo module '...'Import via library module
no-pseudo-modulesDeprecated access of DataType pseudo module '...'Import via library module
no-implicit-globalsAccess of module '...' not exported by library '...'Import module directly
no-implicit-globalsOData built-in global symbols must not be used implicitlyImport ODataExpressionAddons

When to Use

Apply this skill when you see linter output like:

MyController.js:5:5 error Deprecated access of enum pseudo module 'sap/ui/core/BarColor'  no-pseudo-modulesMyController.js:8:5 error Deprecated access of DataType pseudo module 'sap/ui/core/CSSSize'  no-pseudo-modulesMyController.js:15:5 error Access of module 'sap/ui/unified/DateRange' not exported by library 'sap/ui/unified/library'  no-implicit-globalsMyView.view.xml:20:5 error OData built-in global symbols must not be used implicitly  no-implicit-globals

Background: Pseudo Modules

In UI5, enums and DataTypes were historically accessed as if they were modules (e.g., sap/ui/core/BarColor). These are "pseudo modules" - they don't exist as real files but are resolved at runtime from the library module. In modern UI5, direct pseudo module imports are deprecated.

Fix Strategy

1. Enum Pseudo Module Access

Problem: Importing enums as direct modules.

javascript
// Before - triggers no-pseudo-modulessap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/BarColor",           // Pseudo module!    "sap/m/ListSeparators"            // Pseudo module!], function(Controller, BarColor, ListSeparators) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var color = BarColor.Positive;            var separator = ListSeparators.All;        }    });});

Fix Strategy: Import from the library module and access the enum as a property.

javascript
// After - import from librarysap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/library",           // Import library    "sap/m/library"                  // Import library], function(Controller, coreLibrary, mLibrary) {    "use strict";
    // Extract enums from library    var BarColor = coreLibrary.BarColor;    var ListSeparators = mLibrary.ListSeparators;
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var color = BarColor.Positive;            var separator = ListSeparators.All;        }    });});

Common Enum Pseudo Modules and Their Libraries:

Pseudo ModuleLibrary ModuleEnum Access
sap/ui/core/BarColorsap/ui/core/librarycoreLibrary.BarColor
sap/ui/core/ValueStatesap/ui/core/librarycoreLibrary.ValueState
sap/ui/core/TextDirectionsap/ui/core/librarycoreLibrary.TextDirection
sap/ui/core/TextAlignsap/ui/core/librarycoreLibrary.TextAlign
sap/ui/core/MessageTypesap/ui/core/librarycoreLibrary.MessageType
sap/m/ListSeparatorssap/m/librarymLibrary.ListSeparators
sap/m/ListModesap/m/librarymLibrary.ListMode
sap/m/ListTypesap/m/librarymLibrary.ListType
sap/m/ButtonTypesap/m/librarymLibrary.ButtonType
sap/m/InputTypesap/m/librarymLibrary.InputType

2. DataType Pseudo Module Access

Problem: Importing DataTypes as direct modules.

javascript
// Before - triggers no-pseudo-modulessap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/CSSSize"            // DataType pseudo module!], function(Controller, CSSSize) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        // Using CSSSize type    });});

Fix Strategy: Import from the library module.

javascript
// After - import from librarysap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/library"], function(Controller, coreLibrary) {    "use strict";
    var CSSSize = coreLibrary.CSSSize;
    return Controller.extend("my.app.controller.Main", {        // Using CSSSize type    });});

Common DataType Pseudo Modules:

Pseudo ModuleLibrary Module
sap/ui/core/CSSSizesap/ui/core/library
sap/ui/core/CSSColorsap/ui/core/library
sap/ui/core/URIsap/ui/core/library
sap/ui/core/IDsap/ui/core/library
sap/ui/core/Percentagesap/ui/core/library

3. Implicit Globals via Library Access

Problem: Accessing modules via library exports that aren't actually exported.

javascript
// Before - triggers no-implicit-globalssap.ui.define([    "sap/ui/unified/library",    "sap/ui/core/library"], function(unifiedLibrary, coreLibrary) {    "use strict";
    // These modules are NOT exported by the library!    var DateRange = unifiedLibrary.DateRange;              // Error    var DOMAttribute = coreLibrary.tmpl.DOMAttribute;      // Error});

Fix Strategy: Import the module directly.

javascript
// After - import modules directlysap.ui.define([    "sap/ui/unified/DateRange",           // Direct import    "sap/ui/core/tmpl/DOMAttribute"       // Direct import], function(DateRange, DOMAttribute) {    "use strict";
    // Use directly});

Rule of Thumb:

  • Enums and DataTypes: Access via library module (e.g., library.EnumName)
  • Classes/Controls: Import directly (e.g., sap/ui/unified/DateRange)

4. OData Expression Addons

Problem: Using OData built-in functions in expression bindings without importing.

javascript
// Before - triggers no-implicit-globalssap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/m/Text"], function(Controller, Text) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oText = new Text({                // Using odata.compare without import!                text: "{= odata.compare(${/value1}, ${/value2}) }"            });        }    });});

Fix Strategy: Import ODataExpressionAddons module.

javascript
// After - import ODataExpressionAddonssap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/m/Text",    "sap/ui/model/odata/ODataExpressionAddons"  // Required for odata.* functions], function(Controller, Text, ODataExpressionAddons) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oText = new Text({                // Now works - ODataExpressionAddons is imported                text: "{= odata.compare(${/value1}, ${/value2}) }"            });        }    });});

OData Functions Requiring Import:

OData FunctionAlternative Direct Module
odata.comparesap/ui/model/odata/v4/ODataUtils
odata.fillUriTemplatesap/ui/thirdparty/URITemplate
odata.uriEncodesap/ui/model/odata/ODataUtils

Note: Importing sap/ui/model/odata/ODataExpressionAddons is the simplest solution as it registers all OData expression functions.

5. OData Functions in XML Views

Problem: Using OData functions in XML view bindings without import.

xml
<!-- Before - triggers no-implicit-globals --><mvc:View    xmlns:mvc="sap.ui.core.mvc"    xmlns="sap.m">    <Text text="{= odata.compare(${/price1}, ${/price2}) }" /></mvc:View>

Fix Strategy: Add core:require for ODataExpressionAddons.

xml
<!-- After - with core:require --><mvc:View    xmlns:mvc="sap.ui.core.mvc"    xmlns="sap.m"    xmlns:core="sap.ui.core"    core:require="{        ODataAddons: 'sap/ui/model/odata/ODataExpressionAddons'    }">    <Text text="{= odata.compare(${/price1}, ${/price2}) }" /></mvc:View>

Implementation Steps

  1. Identify the issue type from the linter message:

    • "enum pseudo module" → Import from library
    • "DataType pseudo module" → Import from library
    • "not exported by library" → Import module directly
    • "OData built-in global" → Import ODataExpressionAddons

  2. Determine the correct library for enums/DataTypes:

    • Check the module path prefix (e.g., sap/ui/core/ → sap/ui/core/library)

  3. Update imports:

    • Add library import for enums/DataTypes
    • Add direct module import for classes
    • Add ODataExpressionAddons for OData functions

  4. Update code references:

    • Extract enum/DataType from library: var EnumName = library.EnumName;
    • Use directly imported modules

  5. For XML views: Add core:require when needed

Example Fix Session

Given linter output:

MyController.js:3:5 error Deprecated access of enum pseudo module 'sap/ui/core/ValueState'  no-pseudo-modulesMyController.js:4:5 error Access of module 'sap/ui/unified/DateRange' not exported by library 'sap/ui/unified/library'  no-implicit-globalsMyController.js:25:5 error OData built-in global symbols must not be used implicitly  no-implicit-globals

Before:

javascript
sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/ValueState",    "sap/ui/unified/library"], function(Controller, ValueState, unifiedLibrary) {    "use strict";
    var DateRange = unifiedLibrary.DateRange;  // Error: not exported
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var state = ValueState.Error;
            var oDateRange = new DateRange({                startDate: new Date()            });        },
        formatComparison: function() {            return "{= odata.compare(${/val1}, ${/val2}) }";  // Error: no import        }    });});

After:

javascript
sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/library",                          // For ValueState enum    "sap/ui/unified/DateRange",                     // Direct import    "sap/ui/model/odata/ODataExpressionAddons"      // For odata.* functions], function(Controller, coreLibrary, DateRange, ODataExpressionAddons) {    "use strict";
    var ValueState = coreLibrary.ValueState;  // Extract from library
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var state = ValueState.Error;
            var oDateRange = new DateRange({                startDate: new Date()            });        },
        formatComparison: function() {            return "{= odata.compare(${/val1}, ${/val2}) }";  // Now works        }    });});

Notes

  • Library modules only export enums and DataTypes, not classes/controls
  • Always import controls and classes directly by their full module path
  • The ODataExpressionAddons import is needed even though you don't use the variable directly - it registers the functions at load time
  • Pseudo module deprecation helps identify improper dependencies and improves load time optimization

Related Skills

  • fix-js-globals: For other JavaScript global access patterns (no-globals on JS files — e.g., sap.ui.getCore(), jQuery, sap.ui.controller()), use fix-js-globals
  • fix-control-renderer: If pseudo module errors appear in renderer code alongside renderer-specific issues, use fix-control-renderer for the renderer modernization

来源与署名

来源：UI5/plugins-coding-agents位于plugins/ui5-modernization/skills/fix-pseudo-modules提交2b8c4a9

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 UI5/plugins-coding-agents 的技能

Modernize Ui5 App

UI5

编排五阶段 UI5 应用现代化工作流，包含验证关卡和按阶段提交。

Software Development2026年10月8日

Modernize Flp Sandbox

UI5

将 SAP UI5 应用从旧版 FLP 沙箱迁移到新沙箱，重写配置、钩子与测试。

Software Development2026年10月8日

Fix Xml Native Html

UI5

指导将 UI5 XML 视图中已弃用的原生 HTML 和 SVG 替换为等效的 UI5 控件与图标。

Software Development2026年10月8日

Fix Table Row Mode

UI5

将已弃用的 sap.ui.table.Table 行属性转换为 rowMode 聚合，修复 UI5 代码。

Software Development2026年10月8日

Fix Partially Deprecated Apis

UI5

修复 UI5 linter 能检测但无法自动修复的部分弃用 SAP UI5 API 用法。

Software Development2026年10月8日

Fix Manifest Json

UI5

修复 UI5 linter 报告但无法自动修复的 SAP UI5 manifest.json 问题。

Software Development2026年10月8日

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Dpop Adoption

google

精选

指导为 Google OAuth 平台实现 OAuth 2.0 DPoP（RFC 9449）发送方约束刷新令牌。

Software Development21K今天更新

Gemini Live Api

google

精选

生成 Gemini Live API WebSocket 客户端类、测试、文档和用于双向流式传输的演示界面。

Software Development21K今天更新

Gemini Api

google

精选

指导如何在 Google Agent Platform 上使用 Gen AI SDK 调用 Gemini API，涵盖多语言与多项能力。

Software Development21K今天更新