En esta página

Declaración de variables con ámbito de bloque

qmllint denomina esta categoría de advertencia « [block-scope-var-declaration] ».

Se ha declarado una variable con «var» dentro del ámbito de un bloque

¿Qué ha pasado?

Se ha declarado una variable de JavaScript con «var» dentro del ámbito de un bloque, por ejemplo, en el cuerpo de un bucle «while». Aunque pueda parecer que la variable solo se puede utilizar dentro de ese ámbito, en realidad se puede acceder a ella desde fuera, ya que se eleva al ámbito de la función más interna o del enlace QML.

¿Por qué es un problema?

Puede resultar confuso seguir el alcance de una variable de este tipo, y estas pueden ocultar accidentalmente otras variables.

Ejemplo

import QtQuick

Item {
    id: root
    property int count: 0
    function countItems() {
        let sum = 0
        {
            var count = root.children.length
            sum += count
        }
        // ... more additions to sum
        count = sum // modifies the function local variable, not root.count
    }
}

Para solucionar esta advertencia, utiliza «let» o «const» en su lugar, o declara la variable directamente en el ámbito de la función.

import QtQuick

Item {
    id: root
    property int count: 0
    function countItems() {
        let sum = 0
        {
            let count = root.children.length
            sum += count
        }
        // ... more additions to sum
        count = sum // modifies the function local variable, not root.count
    }
}

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.