Hello World
- Methods

Web servers form the foundation of the web, especially the Internet of Things (IoT).

sock = app.CreateWebServer( port, options ) → app object: WebServer

Turning your phone or tablet into a web server or creating a network of interconnected devices is very simple with DroidScript. Set a document root for the server using the SetFolder method of the WebServer object. This is the folder location on your device that your web pages will be served from.
wbs.SetFolder( path );

Start the server using the Start method.

And stop it using the Stop method.

The following example shows how to create a basic webserver for serving pages over WiFi from your device. It will serve a built in demo page.

For simplicity some of the features in the demo page will not work in this first example. Try them and you will see how the server presents errors. The next example shows how to handle all the features of the demo page.

Example - Basic

function OnStart()
    var ip = app.GetIPAddress();
    app.Alert( ip +":8080", "Type the following address into your browser" );

    serv = app.CreateWebServer( 8080 );
    serv.SetFolder( "/sdcard/DroidScript" );

    Copy     Copy All       Run      

The second example shows how to accept file upload and permit directory listings by including permissions in the options parameter of the app.CreateWebServer method.

It also adds a servlet to respond to messsages from the web client. A servelet can be used to process data supplied by a user via form elements or it can handle requests made from the client application.

To get a better understanding of how client - server messaging works you can view the source of the served demo page and the network view in the developer tools of your favorite browser to see how the simple GET request is sent from the client browser to the servlet for processing by the OnServlet function when the Send Message button is clicked.

Example - Servlets

function OnStart()
    var ip = app.GetIPAddress();
    app.Alert( ip +":8080", "Type the following address into your browser" );

    serv = app.CreateWebServer( 8080, "Upload,ListDir" );
    serv.SetFolder( "/sdcard/DroidScript" );
    serv.AddServlet( "/message", OnServlet );


function OnServlet( request, info )
    serv.SetResponse( "Got it!" );
    app.ShowPopup( info.remoteAddress + " says: " + request.msg );
    Copy     Copy All       Run      

Web sockets are faster than servlets and can be used for both client - server applications or peer-to-peer systems where each connected node is both a client and a server without a centralized server.

This makes web sockets very useful for datasharing in multiplayer games.

All requests sent to the same servlet will queue up behind each other and are processed in order. The server application is said to be blocking all other requests whilst a servlet completes each task synchronously.

Web sockets recieve the request and then start a process to handle the request. When the task is complete any data or messages to be returned will be sent back to the relevant connected clients. In this case the server application is said to be non-blocking or asynchronous.
See Also: CreateWebSocket

Web sockets can be used for broadcast purposes, for example sending the same message to all connected clients. They can also be used to send different direct messages to a specific one device using the IP address.

The following example demonstrates web sockets being used to receive messages from and broadcasting messages to connected devices.

Example - Send and Receive messages

var indexhtml = `
    <title>WebSockets Demo</title>

        var count = 0;

        function Connect()
            // Open web socket to phone.
            ws = new WebSocket( "ws://" + );
            ws.onopen = ws_onopen;
            ws.onmessage = ws_onmessage;
            ws.onclose = ws_onclose;
            ws.onerror = ws_onerror;

        function Send() {
            ws.send( "Hello " + count++ );

        function ws_onopen() {
            id_info.innerHTML = "Socket Open";

        function ws_onmessage( msg ) {
            id_info.innerHTML =;

        function ws_onclose() {
            id_info.innerHTML = "Socket Closed";

        function ws_onerror(e) {
            id_info.innerHTML = "Socket Error: " +;

    <h2>DroidScript WebSockets Demo</h2>
    <div id="id_info">Ready</div>
    <button onclick="Connect()">Connect</button>
    <button onclick="Send()">Send Message</button>

var count = 0;

function OnStart()
    // Create the Index.html file
    // note: in regular use move the html to a separate file
    app.WriteFile( "Index.html", indexhtml );

    ip = app.GetIPAddress();
    app.Alert( ip +":8080", "Type the following address into your browser" );


    lay = app.CreateLayout( "linear", "VCenter,FillXY" );

    txt = app.CreateText( "No connected clients.", 0.8, 0.3, "AutoScale,MultiLine" );
    txt.SetTextSize( 22 );
    lay.AddChild( txt );

    txtMsg = app.CreateText( "", 0.8, 0.3, "AutoScale,MultiLine" );
    txtMsg.SetTextSize( 22 );
    lay.AddChild( txtMsg );

    btn = app.CreateButton( "Send Message", 0.4, 0.1);
    btn.SetMargins( 0, 0.05, 0, 0 );
    btn.SetOnTouch( SendMessage );
    lay.AddChild( btn );

    app.AddLayout( lay );

    serv = app.CreateWebServer( 8080 );
    serv.SetFolder( app.GetAppPath() );
    serv.SetOnReceive( serv_OnReceive );

    setInterval( ShowConnections, 3000 );

function ShowConnections()
    var clients = serv.GetWebSockClients();
    var list = [];
    for( var i = 0; i < clients.length; i++ )

    if(list.length) txt.SetText( list.join("\n") );

function SendMessage() {
    serv.SendText( "Hello " + count++ )

function serv_OnReceive( msg, ip ) {
    txtMsg.SetText( ip + ": " + msg );
Copy All       Run      


The following methods are available on the WebServer object:

GetType() → string: “WebServer”
GetWebSockClients() → list: of objects: [{ remoteAddress, id }]
Method( name, types, p1, p2, p3, p4 ) → all types
SendText( txt, ip, id )
number: integer
string: path to file or folder ( “/absolute/...” or “relative/...” )
string: url path
string: comma “,” separated: ListDir or Upload or NoWelcome or Reflect
string: url path: “/name”
object: { parameter: argument }
object: { remoteAddress }
list: boolean,char,byte,short,int,long,float,double,String,CharSequence,...
function( args, info )
function( msg, ip, id )
function( filename, ip )
Redirects a url pattern (with * wildcards) to a target location
Define a callback function which is called when a HTTP GET request on a given servlet name was recieved.
Returns the control class name.
Returns a list of connected client WebSockets.
Allows access to other functions defined on the object in Java via reflection.

Note: This function is a premium feature. Please consider subscribing to Premium to use this feature and support DroidScript in its further development.
Sends a message to a specific client.
If no id is given, all clients of the specified ip are notified.
If neither ip nor id is given, the message will be sent to all connected clients.
Specifies the root folder of the server.
Define a callback function which is called when the server received a message from a client.
Define a callback function which is called when a file was uploaded to the server.
Responds to an incoming HTTP request
Set a folder where uploaded files are to be placed.
Start the server.
Stop server