fs_read_binary

fs_read_binary(filename) reads a binary file from the job’s directory. Returns nil if the file does not exist.

Signature

fs_read_binary(filename)

async

Note

CWD-jailed: Reads from the job’s directory first. Falls back to shared/ folder if not found locally. Absolute paths are not allowed. Unlike fs_read, handles non-UTF-8 files like images and other binary formats.

Parameters

Param	Type	Description
filename	string	File name (relative to job directory)

Returns

Value	Type	Description
content	string / nil	Binary-safe file content, or nil if file does not exist

Example

local png_data = fs_read_binary("screenshot.png")
local resp = http_multipart("https://api.example.com/upload", {
    file = { content = png_data, filename = "page.png", type = "image/png" }
})

See Also

• fs_read - Read text files
• http_multipart - Upload files via HTTP