MARS Engine Docs

Appearance

HTTP Request ​

The request object in MARS Engine lets you access all incoming request data. It is always available in your server-side scripts without needing to import anything.

request.header(name) ​

Returns the value of a specific HTTP request header.

js
let accept = request.header("Accept");
write("header", accept);

Example output:

json
{
  "header": "text/html,application/xhtml+xml,..."
}

Retrieves the value of a cookie by its name.

js
let sessionId = request.cookie("sid");
write("sid", sessionId);

request.param(name) ​

Equivalent to calling the global param() function. Fetches a parameter from:

  • URL path
  • Query string
  • POST body
  • Uploaded files

If not found, returns null.

js
let userId = request.param("user_id");

File upload example with multipart forms:

HTML form:

html
<form method="POST" enctype="multipart/form-data">
  <input type="file" name="upload" />
</form>

Server-side code:

js
let file = request.param("upload");
write("file", { name: file.fileName, size: file.size });

request.ip ​

Returns the client IP address.

js
let ip = request.ip;
write("ip", ip);

request.port ​

Returns the client's source port number.

js
let port = request.port;
write("port", port);

request.isSecure() ​

Returns true if the request was made over HTTPS.

js
let isSecure = request.isSecure();
write("isSecure", isSecure);
  • param() – Retrieves parameters with optional default values.
  • session() – Stores and retrieves session data.