Pascal (Lazarus/Delphi)

Send and Receive WebSocket Frame

See more WebSocket Examples

Demonstrates how to send a websocket text frame to a websocket echo server. This example uses Chilkat's websocket test echo server at ws://websockets.chilkat.io/wsChilkatEcho.ashx

Note: The websockets.chilkat.io server imposes the following limitations:
Messages must be 16K or less, and each connection is limited to a max of 16 echoed messages.

Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.WebSocket,
  Chilkat.Rest;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  ws: TWebSocket;
  rest: TRest;
  responseBodyIgnored: string;
  finalFrame: Boolean;
  receivedStr: string;

begin
  success := False;

  //  This example requires the Chilkat API to have been previously unlocked.
  //  See Global Unlock Sample for sample code.

  ws := TWebSocket.Create;

  //  For brevity, this example does not check for errors when etablishing the WebSocket connection.
  //  See Establish WebSocket Connection for more complete sample code for making the connection.

  rest := TRest.Create;
  //  Connect to websockets.chilkat.io
  //  IMPORTANT: websockets.chilkat.io accepts frames of up to 16K in size and echoes them back.
  //  IMPORTANT: The websockets.chilkat.io server imposes the following limitations: 
  //  ---------- Messages must be 16K or less, and each connection is limited to a max of 16 echoed messages.
  success := rest.Connect('websockets.chilkat.io',80,False,False);
  ws.UseConnection(rest);
  ws.AddClientHeaders();
  responseBodyIgnored := rest.FullRequestNoBody('GET','/wsChilkatEcho.ashx');
  success := ws.ValidateServerHandshake();
  if (success <> True) then
    begin
      WriteLn(ws.LastErrorText);
      Exit;
    end;

  //  This example demonstrates sending a frame and receiving a text frame.

  //  Send a frame containing the string "Hello World!"
  //  This will be the first and final frame, and therefore this constitutes the entire message.
  finalFrame := True;
  success := ws.SendFrame('Hello World!',finalFrame);
  if (success <> True) then
    begin
      WriteLn(ws.LastErrorText);
      Exit;
    end;

  //  Read an incoming frame.
  success := ws.ReadFrame();
  if (success <> True) then
    begin
      WriteLn('Failed to receive a frame');
      WriteLn('ReadFrame fail reason = ' + ws.ReadFrameFailReason);
      WriteLn(ws.LastErrorText);
      Exit;
    end;

  //  Show the string that was received.
  receivedStr := ws.GetFrameData();
  WriteLn('Received: ' + receivedStr);

  //  Close the websocket connection.
  success := ws.SendClose(True,1000,'Closing this websocket.');
  if (success <> True) then
    begin
      WriteLn(ws.LastErrorText);
      Exit;
    end;

  //  Read the Close response.
  success := ws.ReadFrame();
  if (success <> True) then
    begin
      WriteLn('ReadFrame fail reason = ' + ws.ReadFrameFailReason);
      WriteLn(ws.LastErrorText);
      Exit;
    end;

  //  Should receive the "Close" opcode.
  WriteLn('Received opcode: ' + ws.FrameOpcode);
  //  Should be the same status code we sent (1000)
  WriteLn('Received close status code: ' + ws.CloseStatusCode);
  //  The server may echo the close reason.  If not, this will be empty.
  WriteLn('Echoed close reason: ' + ws.CloseReason);

  WriteLn('Success.');


  ws.Free;
  rest.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.