Files
GDevelop/GDJS/Runtime/debugger-client/websocket-debugger-client.ts
T
Florian Rival c37e129a5b Implement support for the Debugger in the web-app
* One or more preview windows can be launched and used with the GDevelop Debugger, like on the desktop app.
  * To run the Debugger, click on the button next to the Play button in the toolbar and choose "Start Preview with Debugger and Performance Profiler"
* This is useful to inspect instances of objects, inspect internal messages or run the performance profiler.
* A right click on the Play button will also allow to launch a new preview, in a new window.
* Also fix the loading screen not shown in the preview on the web-app even when asked to be shown (using the game properties preview button)
2021-11-04 11:48:04 +00:00

76 lines
2.5 KiB
TypeScript

namespace gdjs {
const logger = new gdjs.Logger('Debugger client (websocket)');
/**
* This debugger client connects to a websocket server, exchanging
* and receiving messages with this server.
*/
export class WebsocketDebuggerClient extends gdjs.AbstractDebuggerClient {
_ws: WebSocket | null;
/**
* @param path - The path of the property to modify, starting from the RuntimeGame.
*/
constructor(runtimeGame: RuntimeGame) {
super(runtimeGame);
this._ws = null;
if (typeof WebSocket === 'undefined') {
logger.log("WebSocket is not defined, the debugger won't work.");
return;
}
const that = this;
try {
// Find the WebSocket server to connect to using the address that was stored
// in the options by the editor. If not, try the default address, though it's unlikely
// to work - which is ok, the game can run without a debugger server.
const runtimeGameOptions = runtimeGame.getAdditionalOptions();
const address =
(runtimeGameOptions &&
runtimeGameOptions.websocketDebuggerServerAddress) ||
'127.0.0.1';
const port =
(runtimeGameOptions &&
runtimeGameOptions.websocketDebuggerServerPort) ||
'3030';
this._ws = new WebSocket('ws://' + address + ':' + port + '/');
} catch (e) {
logger.log(
"WebSocket could not initialize, debugger/hot-reload won't work."
);
return;
}
this._ws.onopen = function open() {
logger.info('Debugger connection open');
};
this._ws.onclose = function close() {
logger.info('Debugger connection closed');
};
this._ws.onerror = function errored(error) {
logger.warn('Debugger client error:', error);
};
this._ws.onmessage = function incoming(message) {
let data: any = null;
try {
data = JSON.parse(message.data);
} catch (error) {
logger.info('Debugger received a badly formatted message:', error);
}
that.handleCommand(data);
};
}
protected _sendMessage(message: string) {
if (!this._ws) {
logger.warn('No connection to debugger opened to send a message.');
return;
}
if (this._ws.readyState === 1) this._ws.send(message);
}
}
//Register the class to let the engine use it.
// @ts-ignore
export const DebuggerClient = WebsocketDebuggerClient;
}