Node

A NodeJS program is defined like a browser-based Gren program, except that there is more flexibility regarding how it is initialized.

You can initialize any number of subsystems, like FileSystem or Terminal, before initializing your own program with the results of those initializations.

As part of initializing a subsystem, you usually also get access to a value that permits you to contact said subsystem. Be careful what code you give these permissions to.

Initialization

type alias Environment =
{ platform : Platform
, cpuArchitecture : CpuArchitecture
, args : Array String
, stdout : Stream
, stderr : Stream
, stdin : Stream
}

Contains information about the environment your application was initiated in.

  • platform and cpuArchitecture tells you something about the operating system and machine your application is running on.
  • args is an Array of the arguments passed to your application.
  • stdout, stderr and stdin are streams you can use to communicate with the outside world. Take a closer look at the Stream module for more information.
type Platform
= Win32
| Darwin
| Linux
| FreeBSD
| OpenBSD
| SunOS
| Aix
| UnknownPlatform

The platform, or operating system, that your application is running on.
type CpuArchitecture
= Arm
| Arm64
| IA32
| Mips
| Mipsel
| PPC
| PPC64
| S390
| S390x
| X64
| UnknownArchitecture

The CPU architecture your application is running on.
getEnvironmentVariables : Task Never (Dict String String)

Get a Dict of environment variables.

Simple Program

type alias SimpleProgram a = Program {} a

A simple program that executes a single task and then exits.
defineSimpleProgram : (Environment -> Task (Cmd a)) -> SimpleProgram a

Define a simple program that doesn't require long-lived state or the ability to respond to messages or subscriptions. Ideal for simple and short-lived programs.
endWithCmd : Cmd a -> Task (Cmd a)

When defining a program with defineTask, use this function to define the final command to execute.

Program

type alias Program model msg = Program {} (Model model) (Msg model msg)

The definition of a Gren program that runs on NodeJS.
type alias ProgramConfiguration model msg =
{ init : Environment -> Task { model : model, command : Cmd msg }
, update : msg -> model -> { model : model, command : Cmd msg }
, subscriptions : model -> Sub msg
}

The required functions that define a program.
defineProgram : ProgramConfiguration model msg -> Program model msg

Define a program with access to long-lived state and the ability to respond to messages and listen to subscriptions. If you want to define a simple and short-lived program, chances are you're looking for defineSimple instead.
startProgram :
{ model : model
, command : Cmd cmd
}
-> Task { model : model, command : Cmd cmd
}

This lets the runtime know that you're done initializing other subsystems, and that your program is ready to start.

Exit

exit : Cmd msg

Terminate the program immediatly. It will not wait for tasks like http calls or file system writes, so only use this if you've reached a state where it makes no sense to continue.
exitWithCode : Int -> Cmd msg

Terminate the program immediatly. It will not wait for tasks like http calls or file system writes, so only use this if you've reached a state where it makes no sense to continue.

The exit code can be read by other processes on your system. Any value other than 0 is considered an error.
setExitCode : Int -> Cmd msg

Set the error code that the program will return once it finishes.

Note: This will not terminate your program, so things like http calls or writes to the filesystem will be allowed to complete. However, the program will only exit once there are no ongoing tasks.