Skip to main content
Version: 2.1.x

Recieving data

There are two ways to reciveve data from the server. With ZilaWS data can be asked and waited for.

Asking for data

To ask the server for data, the waiter function can be used. This will trigger a server side MessageHandler and get its return value.

const client = await connectTo("wss://yourhost.com");

console.log(await client.waiter("GetValueOfPI") as number); // --> 3.141592653589793

Waiting for data

MessageHandlers can be registered on client side too. They run when the client recives a message from the server with the event's identifier. The params contain the data. There can be any number of params with any types.

client.setMessageHandler("SomeIdentifier", (param1: string, param2: number, param3: object /*, ...*/) => {
//Your code
});

OR

You can use a onceMessageHandler to register a MessageHandler that only gets executed once.

client.onceMessageHandler("SomeIdentifier", (param1: string, param2: number, param3: object /*, ...*/) => {
//Your code
});

If the server uses the waiter function to send the data down, you can even make the server wait until it is done.

client.setMessageHandler("SomeIdentifier", async (param1: string, param2: number, param3: object /*, ...*/) => {
await new Promise<void>((resolve) =>{
//Your Code is represented by this timeout
setTimeout(() => {
resolve();
}, 3000);
});
});