如何检查APEX页面项是否含特定子字符串？排查indexOf返回-1异常

1. 如何检查APEX页面项是否包含特定子字符串？ #

在APEX里，你可以根据场景选择前端JavaScript或后端PL/SQL两种方式来实现：

前端JavaScript方式 #

APEX自带的$v()函数能快速获取页面项的当前值，搭配原生JS的字符串方法就能完成检查：

• 用includes()方法（最直观，直接返回布尔值）：

  // 检查是否包含"ABC"（区分大小写）
  const hasSubstring = $v("P2_ITEM1").includes("ABC");
  console.log(hasSubstring); // 包含返回true，否则返回false
  

• 用indexOf()方法（返回子字符串的起始索引，不存在则返回-1）：

  const index = $v("P2_ITEM1").indexOf("ABC");
  const hasSubstring = index !== -1;
  console.log(hasSubstring);
  

后端PL/SQL方式 #

如果需要在APEX的进程、验证或计算逻辑中做检查，可以用Oracle的INSTR()函数：

-- 区分大小写检查
IF INSTR(:P2_ITEM1, 'ABC') > 0 THEN
  -- 执行包含子字符串后的业务逻辑
END IF;

-- 不区分大小写检查（统一转大写后对比）
IF INSTR(UPPER(:P2_ITEM1), 'ABC') > 0 THEN
  -- 执行包含子字符串后的业务逻辑
END IF;

2. 为什么indexOf返回-1？排查与更优实现 #

你遇到的这个问题，大概率是以下几个常见原因导致的：

常见问题排查 #

• 大小写不匹配：indexOf是严格区分大小写的，如果页面项的值是"abc"或"Abc"，搜索"ABC"自然会返回-1。解决方法是统一转换为相同大小写再检查：

  const index = $v("P2_ITEM1").toLowerCase().indexOf("abc");
  console.log(index !== -1);
  

• 前后存在空格：页面项的值可能带有前后空格（比如用户输入误加、或页面项格式设置导致），比如" ABC "，直接搜索"ABC"会匹配失败。可以先去除空格：

  const index = $v("P2_ITEM1").trim().indexOf("ABC");
  console.log(index !== -1);
  

• 页面项ID错误：确认你写的P2_ITEM1是否和实际页面项的ID完全一致（APEX页面项ID通常是大写，但也要注意拼写错误）。可以先打印实际值确认：

  console.log("页面项实际值：", $v("P2_ITEM1"));
  

更优实现方式 #

相比indexOf，更推荐用includes()方法，代码更简洁易懂：

// 区分大小写检查
if ($v("P2_ITEM1").includes("ABC")) {
  console.log("页面项包含ABC");
}

// 不区分大小写+去空格的组合检查
const itemValue = $v("P2_ITEM1").trim().toLowerCase();
if (itemValue.includes("abc")) {
  console.log("页面项包含ABC（忽略大小写和前后空格）");
}

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