script/no-restricted-globals
Proibir referências a variáveis globais do ambiente de execução que devem passar por um encapsulamento tipado.
| Severidade padrão | Predefinições | Correção automática | Opções |
|---|---|---|---|
error |
Nenhuma | Não | Opções das regras |
Aplicável a: Scripts JS/TS em SFCs Vue; os exemplos mostram a forma relevante de Options API ou script setup.
Incorreto
O exemplo lê diretamente as variáveis globais restritas por padrão process, localStorage e sessionStorage, ignorando as funções auxiliares explícitas de configuração e armazenamento do projeto.
<script setup lang="ts">
const flag = process.env.FEATURE_FLAG
const token = localStorage.getItem('auth.token')
sessionStorage.setItem('view.scroll', String(window.scrollY))
</script>
Correto
useFeatureFlag, authStorage.read e viewStorage.write removem essas referências diretas às variáveis globais restritas. O window.scrollY restante não é uma restrição padrão desta regra; a segurança em SSR é uma questão separada.
<script setup lang="ts">
// Use a typed config helper that distinguishes server vs. client.
const flag = useFeatureFlag('FEATURE_FLAG')
// Use a typed wrapper that scopes keys and handles SSR / disabled storage.
const token = authStorage.read('auth.token')
viewStorage.write('view.scroll', String(window.scrollY))
</script>
Configuração (Vite+)
import { defineConfig } from "@vizejs/vite-plugin/vite-plus";
export default defineConfig({}).withVue({
linter: {
"preset": "incremental",
"rules": {
"script/no-restricted-globals": "error"
}
},
});
Depois, execute vp run lint.