imgit

Appearance

Platform ​

ts
type Platform = Record<string, unknown> & object;

Defined in: server/platform/platform.ts:2 ↗

Platform-specific APIs used in build operations.

Type declaration ​

base64() ​

ts
base64: (data) => Promise<string>;

Encodes specified binary data to base64 string.

Parameters ​

data ​

Uint8Array

Returns ​

Promise<string>

exec() ​

ts
exec: (cmd) => Promise<{
  err: Error;
  out: string;
}>;

Executes specified command in system shell.

Parameters ​

cmd ​

string

Returns ​

Promise<{ err: Error; out: string; }>

fetch() ​

ts
fetch: (url, abort?) => Promise<Response>;

Fetches a remote resource with specified url.

Parameters ​

url ​

string

abort? ​

AbortSignal

Returns ​

Promise<Response>

fs ​

ts
fs: object;

Local file system access APIs.

fs.exists() ​

ts
exists: (path) => Promise<boolean>;

Returns whether directory or file with specified path exists.

Parameters ​
path ​

string

Returns ​

Promise<boolean>

fs.mkdir() ​

ts
mkdir: (path) => Promise<void>;

Creates directory with specified path (recursive).

Parameters ​
path ​

string

Returns ​

Promise<void>

fs.read() ​

ts
read: <T>(path, encoding) => Promise<T extends "bin" ? Uint8Array : string>;

Returns content of the file with specified path and encoding.

Type Parameters ​
T ​

T extends "bin" | "utf8"

Parameters ​
path ​

string

encoding ​

T

Returns ​

Promise<T extends "bin" ? Uint8Array : string>

fs.remove() ​

ts
remove: (path) => Promise<void>;

Deletes file with specified path.

Parameters ​
path ​

string

Returns ​

Promise<void>

fs.size() ​

ts
size: (path) => Promise<number>;

Returns size of the file with specified path, in bytes.

Parameters ​
path ​

string

Returns ​

Promise<number>

fs.write() ​

ts
write: (path, content) => Promise<void>;

Writes binary array or UTF-8 encoded string to the file with specified path.

Parameters ​
path ​

string

content ​

Uint8Array | string

Returns ​

Promise<void>

log ​

ts
log: object;

Logging and reporting APIs.

log.err() ​

ts
err: (msg) => void;

Logs error message.

Parameters ​
msg ​

string

Returns ​

void

log.info() ​

ts
info: (msg) => void;

Logs informational message.

Parameters ​
msg ​

string

Returns ​

void

log.tty() ​

ts
tty: (msg) => void;

Clears current line and writes to stdout when text terminal is available, ignores otherwise; used for reporting build progress.

Parameters ​
msg ​

string

Returns ​

void

log.warn() ​

ts
warn: (msg) => void;

Logs warning message.

Parameters ​
msg ​

string

Returns ​

void

path ​

ts
path: object;

File system path APIs. All results are expected with forward slashes (even on Windows).

path.basename() ​

ts
basename: (path) => string;

Extracts file name with extension from specified path.

Parameters ​
path ​

string

Returns ​

string

path.dirname() ​

ts
dirname: (path) => string;

Extracts directory name from specified path and normalizes the result.

Parameters ​
path ​

string

Returns ​

string

path.fileUrlToPath() ​

ts
fileUrlToPath: (url) => string;

Converts specified file URL (usually import.meta.url) to local file path.

Parameters ​
url ​

string

Returns ​

string

path.join() ​

ts
join: (...paths) => string;

Joins specified path parts and normalizes the result.

Parameters ​
paths ​

...string[]

Returns ​

string

path.relative() ​

ts
relative: (from, to) => string;

Builds relative path from specified 'from' path to 'to' path.

Parameters ​
from ​

string

to ​

string

Returns ​

string

path.resolve() ​

ts
resolve: (...paths) => string;

Builds absolute path from specified parts and normalizes the result.

Parameters ​
paths ​

...string[]

Returns ​

string

wait() ​

ts
wait: (seconds) => Promise<void>;

Returns promise resolved after specified number of seconds.

Parameters ​

seconds ​

number

Returns ​

Promise<void>