TestCafe中setCookie遇重定向失效及相关设置问题咨询

这个问题我之前帮不少开发者踩过坑——TestCafe的setCookie操作还没完成，页面就因为未认证跳走了，确实头疼。下面给你几个实用的解决方案，从临时测试到真实场景都覆盖到：

如果只是想验证Cookie设置本身是否有效，可以用TestCafe的请求钩子拦截重定向响应，阻止页面跳转。这种方法适合单独调试Cookie逻辑，不涉及完整的认证流程：

import { RequestHook } from 'testcafe';

class BlockRedirectHook extends RequestHook {
    constructor() {
        super();
    }

    async onRequest(event) {
        // 检测到302重定向响应时，修改状态码并清空跳转地址
        if (event.response.statusCode === 302) {
            event.response.statusCode = 200;
            delete event.response.headers.location;
        }
    }
}

const blockRedirect = new BlockRedirectHook();

fixture('测试Cookie设置（禁用重定向）')
    .requestHooks(blockRedirect)
    .page('https://你的Web应用域名.com');

test('验证Cookie是否设置成功', async t => {
    await t.setCookie({
        name: 'auth_token',
        value: 'test_auth_123',
        domain: '你的Web应用域名.com',
        path: '/',
        secure: true // 如果是HTTPS环境需要开启
    });
    
    // 检查Cookie是否正确写入
    const targetCookie = await t.getCookie('auth_token');
    await t.expect(targetCookie.value).eql('test_auth_123');
});

既然重定向是因为未认证，那我们可以在页面加载之前就给Web应用域名设置好有效Cookie，这样服务器检测到Cookie后就不会触发重定向。可以在fixture的前置钩子中完成这个操作：

fixture('带Cookie的重定向测试')
    .beforeEach(async t => {
        // 在页面加载前，提前给应用域名设置认证Cookie
        await t.setCookie({
            name: 'auth_token',
            value: 'valid_user_token',
            domain: '你的Web应用域名.com',
            path: '/',
            secure: true,
            httpOnly: true // 如果应用的认证Cookie是HttpOnly类型
        });
    })
    .page('https://你的Web应用域名.com');

test('验证已认证状态下的页面行为', async t => {
    // 此时页面不会重定向，直接进入应用首页
    await t.expect(t.eval(() => document.title)).eql('应用首页');
});

⚠️ 注意：setCookie的参数（domain、secure、httpOnly等）必须和应用实际使用的Cookie完全匹配，否则浏览器不会识别。

如果你的应用依赖HttpOnly类型的Cookie（这种Cookie无法通过前端JS操作），或者需要给外部认证域名设置Cookie，可以用请求钩子在初始请求的请求头中直接注入Cookie，让服务器端直接识别认证状态：

import { RequestHook } from 'testcafe';

class InjectAuthCookieHook extends RequestHook {
    constructor() {
        super();
    }

    async onRequest(event) {
        // 给初始请求添加Cookie请求头
        event.request.headers['Cookie'] = 'auth_token=valid_user_token; path=/; domain=你的Web应用域名.com';
    }
}

const injectCookie = new InjectAuthCookieHook();

fixture('通过请求注入Cookie避免重定向')
    .requestHooks(injectCookie)
    .page('https://你的Web应用域名.com');

test('验证服务器端识别认证状态', async t => {
    // 服务器收到带Cookie的请求，不会触发重定向
    await t.expect(t.eval(() => window.location.href)).notContains('外部认证域名.com');
});

• 用await t.debug()在测试中暂停，打开浏览器开发者工具查看Cookie是否正确写入，或者页面跳转的具体时机。
• 如果涉及跨域认证，确保TestCafe的测试环境允许跨域Cookie操作（TestCafe默认会放宽测试环境的跨域限制，但仍需保证域名匹配）。

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