Using the net Module

Search…
When your transaction test script needs to establish a TCP connection with a network target, you'll use the net module. The ThousandEyes runtime environment for transaction scripts includes the net module for creating raw TCP client sockets to servers on arbitrary ports.
Importing the Module
To use the net module, make sure to first import it within your transaction script:
import net from 'thousandeyes';
Creating a Connection
To create a client connection to a remote server, use the net.connect function:
await net.connect(<port>, '<host.ip.address>');
Sending Data
To send data over the socket connection, first assign the result of net.connect to a variable:
let socket = await net.connect(80, '1.1.1.1');
Then, use the write or writeAll methods to send data over the socket:
await socket.writeAll('GET / HTTP/1.1\r\n\r\n');
To read from the socket, use the read or readAll methods:
const response = await socket.readAll();
Example GET Request
In the following example, notice that first the net module is imported. Then, after net.connect is called, data is sent and received over the socket, using write and read:
1
import {net} from 'thousandeyes';
2
​
3
runScript();
4
​
5
async function runScript() {
6
   let host = 'newyork.wan.the-acme-corporation.net';
7
   let port = 80;
8
   let requestBody =
9
`GET / HTTP/1.1
10
Host: ${host}
11
User-Agent: thousandeyes-transaction
12
`
13
​
14
  let client = await net.connect(port, host);
15
  await client.write(requestBody);
16
  let response = await client.read();
17
​
18
  console.log(response.toString());
19
​
20
};
Copied!
Advanced Examples
For additional examples, see the public repository of ThousandEyes transaction scripts.
Example: IMAP Login
In the following example, you establish a TCP connection; then send IMAP credentials over the connection you've created:
1
let host = 'box.the-acme-corporation.net';
2
   let port = 993;
3
   let imap_password = credentials.get('[email protected]');
4
​
5
   const sock = await net.connectTls(port, host, {
6
       minVersion: 'TLSv1.2',
7
   });
8
​
9
   sock.setEncoding('utf8');
10
​
11
   let imap_commands = [
12
       `? LOGIN [email protected] ${imap_password}\n`,
13
       `? SELECT Inbox\n`,
14
       `? FETCH 1:1 RFC822\n`,
15
   ]
16
​
17
   for(var i=0; i < imap_commands.length; i++){
18
       let command = imap_commands[i];
19
       await sock.writeAll(command);
20
​
21
       // Make driver sleep for .5 seconds
22
       await driver.sleep(500);
23
       console.log(command);
24
       let response = await sock.read();
25
       console.log(response);
26
   }
Copied!
Using the node-fetch Module
Using the tls Module
Last modified 5mo ago
Copy link
Contents
Importing the Module
Creating a Connection