1
/****************************************************************************
3
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
4
** Contact: http://www.qt-project.org/legal
6
** This file is part of the QtSCriptTools module of the Qt Toolkit.
8
** $QT_BEGIN_LICENSE:LGPL$
9
** Commercial License Usage
10
** Licensees holding valid commercial Qt licenses may use this file in
11
** accordance with the commercial license agreement provided with the
12
** Software or, alternatively, in accordance with the terms contained in
13
** a written agreement between you and Digia. For licensing terms and
14
** conditions see http://qt.digia.com/licensing. For further information
15
** use the contact form at http://qt.digia.com/contact-us.
17
** GNU Lesser General Public License Usage
18
** Alternatively, this file may be used under the terms of the GNU Lesser
19
** General Public License version 2.1 as published by the Free Software
20
** Foundation and appearing in the file LICENSE.LGPL included in the
21
** packaging of this file. Please review the following information to
22
** ensure the GNU Lesser General Public License version 2.1 requirements
23
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
25
** In addition, as a special exception, Digia gives you certain additional
26
** rights. These rights are described in the Digia Qt LGPL Exception
27
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
29
** GNU General Public License Usage
30
** Alternatively, this file may be used under the terms of the GNU
31
** General Public License version 3.0 as published by the Free Software
32
** Foundation and appearing in the file LICENSE.GPL included in the
33
** packaging of this file. Please review the following information to
34
** ensure the GNU General Public License version 3.0 requirements will be
35
** met: http://www.gnu.org/copyleft/gpl.html.
40
****************************************************************************/
42
#ifndef QSCRIPTDEBUGGERBACKEND_P_H
43
#define QSCRIPTDEBUGGERBACKEND_P_H
49
// This file is not part of the Qt API. It exists purely as an
50
// implementation detail. This header file may change from version to
51
// version without notice, or even be removed.
56
#include <QtCore/qobjectdefs.h>
58
#include <QtCore/qpair.h>
60
#include "qscriptbreakpointdata_p.h"
61
#include "qscriptscriptdata_p.h"
67
class QScriptDebuggerCommandExecutor;
68
class QScriptDebuggerEvent;
70
class QScriptValueIterator;
71
class QScriptObjectSnapshot;
74
typedef QPair<QList<qint64>, QList<qint64> > QScriptScriptsDelta;
75
typedef QPair<QList<qint64>, QList<qint64> > QScriptContextsDelta;
77
class QScriptDebuggerBackendPrivate;
78
class Q_AUTOTEST_EXPORT QScriptDebuggerBackend
81
QScriptDebuggerBackend();
82
virtual ~QScriptDebuggerBackend();
84
void attachTo(QScriptEngine *engine);
87
QScriptEngine *engine() const;
89
void stepInto(int count = 1);
90
void stepOver(int count = 1);
92
void continueEvalution();
93
void interruptEvaluation();
94
void runToLocation(const QString &fileName, int lineNumber);
95
void runToLocation(qint64 scriptId, int lineNumber);
96
void returnToCaller(int contextIndex, const QScriptValue &value);
97
void evaluate(int contextIndex, const QString &program,
98
const QString &fileName, int lineNumber);
100
int setBreakpoint(const QScriptBreakpointData &data);
101
bool deleteBreakpoint(int id);
102
void deleteAllBreakpoints();
103
QScriptBreakpointData breakpointData(int id) const;
104
bool setBreakpointData(int id, const QScriptBreakpointData &data);
105
QScriptBreakpointMap breakpoints() const;
107
QScriptScriptMap scripts() const;
108
QScriptScriptData scriptData(qint64 id) const;
109
void scriptsCheckpoint();
110
QScriptScriptsDelta scriptsDelta() const;
111
qint64 resolveScript(const QString &fileName) const;
113
int contextCount() const;
114
QScriptContext *context(int index) const;
115
QStringList backtrace() const;
116
QList<qint64> contextIds() const;
117
QScriptContextsDelta contextsCheckpoint();
119
int newScriptObjectSnapshot();
120
QScriptObjectSnapshot *scriptObjectSnapshot(int id) const;
121
void deleteScriptObjectSnapshot(int id);
123
int newScriptValueIterator(const QScriptValue &object);
124
QScriptValueIterator *scriptValueIterator(int id) const;
125
void deleteScriptValueIterator(int id);
127
QScriptValue traceFunction() const;
128
QScriptValue assertFunction() const;
129
QScriptValue fileNameFunction() const;
130
QScriptValue lineNumberFunction() const;
132
void doPendingEvaluate(bool postEvent);
134
bool ignoreExceptions() const;
135
void setIgnoreExceptions(bool ignore);
137
QScriptDebuggerCommandExecutor *commandExecutor() const;
138
void setCommandExecutor(QScriptDebuggerCommandExecutor *executor);
140
virtual void resume() = 0;
143
virtual void event(const QScriptDebuggerEvent &event) = 0;
146
QScriptDebuggerBackend(QScriptDebuggerBackendPrivate &dd);
147
QScopedPointer<QScriptDebuggerBackendPrivate> d_ptr;
150
Q_DECLARE_PRIVATE(QScriptDebuggerBackend)
151
Q_DISABLE_COPY(QScriptDebuggerBackend)