Skip to content

noQwikUseVisibleTask

¥Summary

¥How to configure

biome.json
{
"linter": {
"rules": {
"correctness": {
"noQwikUseVisibleTask": "error"
}
}
}
}

¥Description

禁止在 Qwik 组件中使用 useVisibleTask$() 函数。

¥Disallow useVisibleTask$() functions in Qwik components.

防止阻塞 Qwik 恢复功能的 hydration 操作。请参阅 Qwik 任务文档 获取合适的替代方案。

¥Prevents hydration-blocking operations that hurt Qwik’s resumability. See Qwik Tasks Documentation for proper alternatives.

¥Examples

¥Invalid

useVisibleTask$(() => {
console.log('Component is visible');
});
code-block.js:1:1 lint/correctness/noQwikUseVisibleTask ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Avoid useVisibleTask$ for non-interactive initialization

> 1 │ useVisibleTask$(() => {
^^^^^^^^^^^^^^^
2 │ console.log(‘Component is visible’);
3 │ });

This hook executes immediately on component mount without user interaction, potentially:
- Hurting performance (blocking hydration)
- Causing layout shifts (CLS)
- Breaking SSR compatibility

Check the Qwik documentation for suitable alternatives.

¥Valid

useTask$(() => {
console.log('Task executed');
});

¥Related links