recursion-depth-errors.qdoc

Go to the documentation of this file.

// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
 
/*!
\page qmllint-warnings-and-errors-recursion-depth-errors.html
\ingroup qmllint-warnings-and-errors
 
\title Recursion depths errors
\brief [recursion-depth-errors] Qml statement or expression is too deeply nested.
 
\qmllintwarningcategory recursion-depth-errors
 
\section1 Maximum statement or expression depth exceeded
\section2 What happened?
A QML statement or expression was too deeply nested for the compiler. This usually only happens for
generated code where statements or expressions can be very long, as the recursion limit is usually
large enough for any sensible QML document.
 
\section2 Why is this bad?
The QML engine will not be able to run this code.
 
\section2 Example
\qml
import QtQuick
 
Item {
    function f() {
        let x = 1 + 1 + .... + 1 // maximum depth exceeded: add too many ones together
        return x
    }
 
    Item { Item { .... } } // maximum depth exceeded: too many nested Item's
}
\endqml
 
To fix this warning, auto-generate smaller code pieces. Split deeply nested
Components in multiple files or inline components, or split deeply nested
expressions into multiple expressions:
\qml
import QtQuick
 
Item {
    function f() {
        let x = 1 + 1 + .... + 1 // first half of the split
        x += 1 + 1 + .... + 1 // second half of the split
        return x
    }
 
    component NestedItem : Item { Item {... }} // first half of the nested Item
    component DeeplyNestedItem: Item { ... NestedItem{} ... } // second half of the nested Items + NestedItem
    DeeplyNestedItem {}
}
\endqml
*/