如何让Cypress仅按查询参数名拦截API请求？

API 探路者

2026-6-20

Cypress拦截API时匹配存在指定查询参数（忽略值）的解决方案

要实现只匹配存在clientId查询参数、不限制其具体值的拦截，你可以用以下两种方法：

方法一：使用正则表达式匹配任意值

直接将clientId的匹配值设为正则表达式，匹配任意非空内容（确保参数存在且有值）：

cy
  .intercept({
    pathname: '/api/program/v1/program',
    query: {
      clientId: /.+/  // 匹配任意非空的clientId参数值
    }
  })
  .as('createProgram');

如果允许clientId为空值，可将正则改为/.*/。

方法二：使用自定义函数判断参数存在

如果需要更灵活的判断逻辑（比如仅要求参数存在，不管值是否为空），可以给query传入一个判断函数：

cy
  .intercept({
    pathname: '/api/program/v1/program',
    query: (queryObj) => {
      return 'clientId' in queryObj;  // 只要查询参数中包含clientId键即匹配
    }
  })
  .as('createProgram');