Coma
qmllint escribe esta categoría de advertencia como « [comma] ».
No utilices expresiones con comas
¿Qué ha pasado?
Se ha utilizado una expresión con coma en JavaScript fuera de un bucle «for».
¿Por qué es un error?
Las expresiones con coma reducen la legibilidad del código y ocultan los efectos secundarios.
Ejemplo
import QtQuick
Item {
Component.onCompleted: init(config, true), enableLogging(categories), run(1000) // millis
}Para solucionar esta advertencia, reestructura el código para utilizar sentencias distintas para cada operación. De esta forma, cada efecto secundario queda explícito, en lugar de producirse como parte de otra operación no relacionada:
import QtQuick
Item {
Component.onCompleted: {
init(config, true)
enableLogging(categories)
run(1000) // millis
}
}Además, hay algunas consideraciones especiales para los casos en los que aparecen expresiones con coma porque se captura intencionadamente una variable para un enlace, como en el siguiente código, donde ` previewOfFirstPage ` es una función definida en C++ que depende internamente de ` Config.fontSize`:
Text {
// This causes the function to re-run when fontSize changes
text: Config.fontSize, documentProvider.previewOfFirstPage()
}Si te encuentras con esta situación, considera uno de los siguientes enfoques:
- Si una función como
previewOfFirstPagedepende de una propiedad, es preferible hacer explícita esta dependencia pasando el valor como argumento.Text { text: documentProvider.previewOfFirstPage(Config.fontSize) } - Si no es conveniente cambiar la firma de la función por motivos relacionados con la API, plantéate sustituir la función por un ` Q_PROPERTY `, de modo que se puedan emitir notificaciones de cambio cuando se modifique la dependencia en C++:
void Config::setFontSize(int fontSize) { if (m_fontSize == fontSize) return; m_fontSize = fontSize; emit fontSizeChanged(); emit previewOfFirstPageChanged(); }Text { text: documentProvider.previewOfFirstPage } - Si no es posible modificar la implementación en C++ ni añadir dependencias de QML, utiliza una directiva `
qmllint` para silenciar la advertencia. Incluye un comentario en el que se explique que la intención es capturar la variable en el enlace.Text { // This causes the function to re-run when fontSize changes text: Config.fontSize, documentProvider.previewOfFirstPage() // qmllint disable comma }
© 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.