Awesome
This proposal has been archived in favor of a simpler Hack-pipes proposal, which is a subset of this proposal.
Smart pipelines
ECMAScript Stage-0 Proposal. Living Document. J. S. Choi, 2018-12.
This proposal introduces a new binary pipe operator |>
to JavaScript. It's similar
to the pipe operators of other languages: Clojure, Elixir and Erlang,
Elm, F#, Hack, Julia, LiveScript, OCaml, Perl 6, R with magrittr, and Unix shells and PowerShell.
value
|> await #
|> doubleSay(#, ', ')
|> capitalize // This is a function call.
|> # + '!'
|> new User.Message(#)
|> await #
|> console.log; // This is a method call.
// (The # token isn't final; it might instead be @ or ? or %.)
The proposal is currently at Stage 0 of the TC39 process and is planned to be presented, along with a competing proposal, to TC39 by Daniel “littledan” Ehrenberg of Igalia. The Core Proposal is a variant of the first pipe-operator proposal also championed by Ehrenberg; this variant is listed as Proposal 4: Smart Mix in the pipe-proposal wiki. The variant resulted from previous discussions in the previous pipe-operator proposal, discussions which culminated in an invitation by Ehrenberg to try writing a specification draft.
An update to the existing pipeline Babel plugin is also being developed jointly between the author of this proposal and James DiGioia, the author of the competing proposal. The update will support both this proposal and the other proposal, configurable with a flag.
You can take part in discussions on the original proposal's GitHub issue tracker. When you file an issue, please note in it that you are talking specifically about “Proposal 4: Smart Mix”.
This specification currently uses #
as a “topic reference”, but that choice is
not set in stone. @
, ?
, %
, or many other symbols could also be used.
Bikeshedding discussions over what characters to use for the topic token have
been occurring on GitHub at tc39/proposal-pipeline-operator
issue #91.
This proposal makes many other trade-offs that are also not set in stone. The proposal can and will change in response to feedback once the Babel plugin is implemented. The Babel plugin is planned to be configurable, allowing hands-on experimentation with these trade-offs.
<table> <thead> <tr> <th>With smart pipelines <th>Status quo <tbody> <tr> <td>The infix “smart” pipe operator |>
proposed here would provide a
backwards- and forwards-compatible style of
chaining nested expressions into a readable, left-to-right manner.
Using a [zero-cost abstraction][zero runtime cost], nested data transformations become [untangled into short steps][untangled flow].
<td>Nested, deeply composed expressions occur often in real-world JavaScript. They occur whenever any single value must be processed by a series of data transformations, whether they be operations, functions, or constructors. Unfortunately, these deeply nested expressions often result in messy spaghetti code, due to their mixing of prefix, infix, and postfix expressions together. Writing such code requires many nested levels of indentation and parentheses. Reading such code requires checking both the left and right of each subexpression to understand its data flow.
<tr> <td>promise
|> await #
|> # || throw new TypeError(
`Invalid value from ${promise}`)
|> doubleSay(#, ', ')
|> capitalize
|> # + '!'
|> new User.Message(#)
|> await stream.write(#)
|> console.log;
With smart pipelines, code becomes terser and, literally, more straightforward. Prefix, infix, and postfix expressions would be less tangled together in threads of spaghetti. Instead, data values would be piped from left to right through a single linear thread of postfix expressions, with a [single level of indentation][untangled flow] and four fewer pairs of parentheses – essentially forming a reverse Polish notation.
The resulting code’s terseness and linearity may be both easier for the JavaScript developer to read and to edit. This uniform postfix notation preserves locality between related code; the reader may follow the flow of data more easily through this [single linear thread of postfix operations][untangled flow]. And the developer may more easily add or remove operations at the beginning, end, or middle of the thread, without changing the indentation of unrelated lines.
<td>console.log(
await stream.write(
new User.Message(
capitalize(
doubledSay(
await promise
|| throw new TypeError(
`Invalid value from ${promise}`)
), ', '
) + '!'
)
)
);
Compared with the pipeline version, this non-pipeline version requires additional indentation and grouping on each step. This requires four more levels of indentation and four more pairs of parentheses.
In addition, much related code is here separated by unrelated code. Rather than
a uniform postfix chain, operations appear either before the previous
step’s expression (await stream.write(…)
,new User.Message(…)
,
capitalize(…)
, doubledSay(…)
, await …
) but also after (… || throw new TypeError()
, … + '!'
). An additional argument to function calls (such as
,
in doubledSay(…, ', ')
) is also separated from its function calls,
forming another easy-to-miss “postfix” argument.
Each step of a pipeline creates its own lexical scope, within which the #
token (the topic reference) is immutably to the result of the previous
step (the topic). In this way, it acts as a placeholder for each step’s input.
input // step 0
|> # + 1 // step 1
|> f(x, #, y) // step 2
|> await g(#, z) // step 3
|> console.log(`${#}!`); // step 4
The use of #
as the topic reference is not set in stone. @
, ?
, %
, or
many other symbols could also be used. Bikeshedding discussions over what characters
to use for the topic token have been occurring on GitHub at tc39/proposal-pipeline-operator
issue #91.
console.log(`${ // step 4
await g( // step 3
f(x, // step 2
input + 1, // step 1
y), // step 2
z) // step 3
}!`); // step 4
<tr>
<td>
input |> (# = 50);
// 🚫 Reference Error:
// Cannot assign to topic reference.
The topic binding is immutable, established only once per pipeline step.
It is an error to attempt to assign a value to it using =
, whether inside or
outside a pipeline step.
This chained pipeline:
input
|> # - 3
|> -#
|> # * 2
|> Math.max(#, 0)
|> console.log;
<td>
…is equivalent to the tangled nested expression:
console.log(
Math.max(
-(input - 3) * 2,
0
)
);
<tr>
<td>
The syntax is statically term rewritable into already valid code in this way, with [theoretically zero runtime cost][zero runtime cost].
Similar use cases appear numerous times in real-world JavaScript code,
whenever any input is transformed by expressions of any type:
function calls, property calls, method calls, object constructions, arithmetic
operations, logical operations, bitwise operations, typeof
, instanceof
,
await
, yield
and yield *
, and throw
expressions.
function doubleSay (str, separator) {
return `${str}${separator}${string}`;
}
function capitalize (str) {
return str[0].toUpperCase()
+ str.substring(1);
}
promise
|> await #
|> # || throw new TypeError()
|> doubleSay(#, ', ')
|> capitalize
|> # + '!'
|> new User.Message(#)
|> await stream.write(#)
|> console.log;
This pipeline is also relatively linear, with only one level of indentation, and with each transformation step on its own line.
… |> capitalize
uses a special shortcut called the bare style, explained further below.
It is a bare unary function call that is, in this case, equivalent to … |> capitalize(#)
.
function doubleSay (str, separator) {
return `${str}${separator}${str}`;
}
function capitalize (str) {
return str[0].toUpperCase()
+ str.substring(1);
}
console.log(
await stream.write(
new User.Message(
capitalize(
doubledSay(
await promise
|| throw new TypeError(
`Invalid value from ${promise}`)
), ', '
) + '!'
)
)
);
This deeply nested expression has four levels of indentation instead of two.
Reading its data flow requires checking both the beginning of each expression
(new User.Message
, capitalizedString
, doubledSay
, await promise
and
end of each expression (|| throw new TypeError()
, , ', '
, + '!'
)).
x = … |> f(#, #);
x = … |> [#, # * 2, # * 3];
The topic reference may be used multiple times in a pipeline step. Each use refers to the same value (wherever the topic reference is not overridden by another, inner pipeline’s topic scope). Because it is bound to the result of the topic, the topic is still only ever evaluated once.
<td>{
const $ = …;
x = f($, $);
}
{
const $ = …;
x = [$, $ * 2, $ * 3];
}
This is equivalent to assigning the topic value to a unique variable, then using that variable multiple times in an expression.
<tr> <td>promise
|> await #
|> # || throw new TypeError()
|> `${#}, ${#}`
|> #[0].toUpperCase() + #.substring(1)
|> # + '!'
|> new User.Message(#)
|> stream.write
|> console.log;
When tiny functions are only used once, and when their bodies would be obvious and self-documenting in meaning, then they might be ritual boilerplate that a developer may prefer to inline: trading off self-documentation for localization of code.
<td>{
const promiseValue = await promise
|| throw new TypeError();
const doubledValue =
`${promiseValue}, ${promiseValue}`;
const capitalizedValue
= doubledValue[0].toUpperCase()
+ doubledValue.substring(1);
const exclaimedValue
= capitalizedValue + '!';
const userMessage =
new User.Message(exclaimedValue);
const writeValue =
stream.write(userMessage);
console.log(writeValue);
}
Using a sequence of variables instead has both advantages and disadvantages. The variable names may be self-documenting. But they also are verbose. They visually distract from the crucial data transformations (overemphasizing the expressions’ nouns over their verbs), and it is easy to typo their names.
<tr> <td>promise
|> await #
|> # || throw new TypeError()
|> normalize
|> `${#}, ${#}`
|> #[0].toUpperCase() + #.substring(1)
|> # + '!'
|> new User.Message(#)
|> await stream.write(#)
|> console.log;
With a pipeline, there are no unnecessary variable identifiers. Inserting a new
step in between two steps (or deleting a step) only touches one new line. Here,
a call of a function normalize
was inserted between the second and third steps.
{
const promiseValue = await promise
|| throw new TypeError();
const normalizedValue = normalize();
const doubledValue =
`${normalizedValue}, ${normalizedValue}`;
const capitalizedValue =
doubledValue[0].toUpperCase()
+ doubledValue.substring(1);
const exclaimedValue =
capitalizedValue + '!';
const userMessage =
new User.Message(exclaimedValue);
const writeValue =
stream.write(userMessage);
console.log(writeValue);
}
This code underwent a similar insertion of normalize
. With a series of
variables, inserting a new step in between two other steps (or deleting a step)
requires editing the variable names in the following step.
input |> f |> [0, 1, 2, ...#] |> g;
A pipeline step may contain array literals.
<td>g([0, 1, 2, ...f(input)]);
<tr>
<td>
A topic-style pipeline step may also contain object literals. However, pipeline steps that are entirely object literals must be parenthesized. It is similar to how arrow functions distinguish between object literals and blocks.
input |> f |> ({ x: #, y: # }) |> g;
This is for forward compatibility with Additional Feature BP, which introduces block pipeline steps. (It is expected that block pipelines would eventually be much more common than pipelines with object literals.) This restriction could be dropped, although that would make Additional Feature BP impossible forever.
input |> f |> { x: #, y: # } |> g;
// 🚫 Syntax Error:
// Unexpected token `{`.
// Cannot parse base expression.
<td>
{
const $ = f(input);
g({ x, $: y: f($) });
}
<tr>
<td>
f = input
|> f
|> (x => # + x);
A topic-style pipeline step may contain an inner arrow function. Both versions
of this example result in an arrow function in a closure on the previous
pipeline’s result input |> f
.
{
const $ = f(input);
x => $ + x;
}
The arrow function lexically closes over the topic value, takes one parameter, and returns the sum of the topic value and the parameter.
<tr> <td>input
|> f
|> settimeout(() => # * 5)
|> processIntervalID;
This ability to create arrow functions, which do not lexically shadow the topic, can be useful for using callbacks in a pipeline.
<td>{
const $ = f(input);
const intervalID = settimeout(() => $ * 5);
processIntervalID(intervalID);
}
The topic value of the second pipeline step (here represented by a normal
variable $
) is still lexically accessible within its body, an arrow function,
in both examples.
input
|> f
|> (() => # * 5)
|> settimeout
|> processIntervalID;
The arrow function can also be created on a separate pipeline step.
<td>{
const $ = f(input);
const callback = () => $ * 5;
const intervalID = settimeout(callback);
processIntervalID(intervalID);
}
The result here is the same.
<tr> <td>input
|> f
|> () => # * 5
|> settimeout
|> processIntervalID;
// 🚫 Syntax Error:
// Unexpected token `=>`.
// Cannot parse base expression.
Note, however, that arrow functions have looser precedence than the pipe operator. This means that if a pipeline creates an arrow function alone in one of its steps, then the arrow-function expression must be parenthesized. (The same applies to assignment and yield operators, which are also looser than the pipe operator.) The example above is being parsed as if it were:
(input |> f |> ()) =>
(# * 5 |> settimeout |> processIntervalID);
// 🚫 Syntax Error:
// Unexpected token `=>`.
// Cannot parse base expression.
The arrow function must be parenthesized, as with any other looser-precedence expression:
input
|> (f, g)
|> (() => # * 5)
|> settimeout
|> processIntervalID;
<td>
<tr>
<td>
There is a shortcut for the very common case of unary function calls on variables or variables’ methods. In these cases, the topic reference can be left out. (This is the bare style of the pipe operator.)
promise
|> await #
|> # || throw new TypeError()
|> doubleSay(#, ', ')
|> capitalize
|> # + '!'
|> new User.Message(#)
|> await stream.write(#)
|> console.log;
In this example, it is not necessary to include the parenthesized argument (#
)
for capitalize
and console.log
. They were tacitly implied, forming tacit unary
function calls. In other words, the example above is equivalent to the version in the next row.
console.log(
await stream.write(
new User.Message(
capitalize(
doubledSay(
await promise
|| throw new TypeError(
`Invalid value from ${promise}`)
), ', '
) + '!'
)
)
);
<tr>
<td>
promise
|> await #
|> # || throw new TypeError(
`Invalid value from ${#}`)
|> doubleSay(#, ', ')
|> capitalize(#)
|> # + '!'
|> new User.Message(#)
|> await stream.write(#)
|> console.log(#);
This version is equivalent to the version above, except that the
|> capitalize(#)
and |> console.log(#)
pipeline steps explicitly include
optional topic references #
, making the expressions slightly wordier than
necessary. (Any pipeline step that isn’t in bare style is said to be
in topic style, because it uses the topic reference somewhere in its expression.)
console.log(
await stream.write(
new User.Message(
capitalize(
doubledSay(
await promise
|| throw new TypeError(
`Invalid value from ${promise}`)
), ', '
) + '!'
)
)
);
<tr>
<td>
Being able to automatically detect this “bare style” is the smart part of the “smart pipe operator”. The styles of functional programming, dataflow programming, and tacit programming may particularly benefit from bare pipelines and their terse function application.
<td> <tr> <td>const object = input
|> f
|> # + 2
|> # * 3
|> -#
|> g(#, x)
|> o.unaryMethod
|> await asyncFunction(#)
|> await o.asyncMethod(#)
|> new Constructor(#);
This pipeline is a very linear expression, with only one level of indentation, and with each transformation step on its own line.
As with the previous examples, the … |> f
is a bare unary function call, equivalent
to … |> f(#)
. The topic reference #
is unnecessary; it is invisibly, tacitly implied. The
same goes for o.unaryMethod
, which is a unary function call on o.unaryMethod
.
This is the smart part of the smart pipe operator, which can distinguish between two syntax styles (bare style vs. topic style) by using a simple rule: bare style uses only identifiers and dots – and never parentheses, brackets, braces, or other operators. And topic style always contains at least one topic reference. For more information, see the reference below about the smart step syntax.
<td>const object =
new Constructor(
await o.asyncMethod(
await asyncFunction(
o.unaryMethod(
g(
-(f(input) + 2)
* 3,
x
)
)
)
)
);
In contrast to the version with pipes, this code without pipes is deeply nested, not linear.
The expression has two levels of indentation instead of one. Reading its data flow requires checking both the beginning and end of each expression, and each step expression gradually increases in size.
Inserting or removing any step of the data flow also requires changes to the indentation of any previous steps’ lines.
<tr> <td>input |> x + 50 |> f |> g(x, 2);
// 🚫 Syntax Error:
// Topic-style pipeline step
// `|> x + 50`
// binds topic but contains
// no topic reference.
// 🚫 Syntax Error:
// Topic-style pipeline step
// `|> g(x, 2)`
// binds topic but contains
// no topic reference.
In order to fulfill the goal of “don’t shoot me in the foot”,
when a pipeline step is in topic style but it contains no topic
reference, that is currently an early error. Such a degenerate
pipeline step has a very good chance of actually being an accidental bug. (The
bare-style pipeline step |> f
is not an error. The bare style is not
supposed to contain any topic references #
.)
For instance, this code may be clear enough:
input |> object.method;
It is a valid bare-style pipeline. Bare style is designed to be strictly simple: it must either be a simple reference or it is not in bare style.
<td>It means:
object.method(input);
<tr>
<td>
But this code would be less clear. That is why it is an early Syntax Error:
input |> object.method();
// 🚫 Syntax Error:
// Topic-style pipeline step
// `|> object.method()`
// binds topic but contains
// no topic reference.
It is an invalid topic-style pipeline. It is in topic style because it is not a simple reference; it has parentheses. And it is invalid because it is in topic style yet it does not have a topic reference.
<td>Had that code not been an error, it could reasonably mean either of these lines:
object.method(input);
object.method()(input);
<tr>
<td>
Instead, the developer must clarify what they mean, using a topic reference, into either of these two valid topic-style pipelines:
input |> object.method(#);
input |> object.method()(#);
The reading developer benefits from explicitness and clarity, without sacrificing the benefits of [untangled flow][] that pipelines bring.
<td>object.method(input);
object.method()(input);
<tr>
<td>
Adding other arguments:
input |> object.method(x, y);
// 🚫 Syntax Error:
// Topic-style pipeline step
// `|> object.method(x, y)`
// binds topic but contains
// no topic reference.
…would make this problem of semantic ambiguity worse. But the reader is protected from this ambiguity by the same early error.
<td>That code could have any of these reasonable interpretations:
object.method(input, x, y);
object.method(x, y, input);
object.method(x, y)(input);
Both inserting the input as the first argument and inserting it as the last argument are reasonable interpretations, as evidenced by how other programming languages’ pipe operators variously do either. Or it could be a factory method that creates a function that is in turn to be called with a unary input argument.
<tr> <td>The writer must clarify which of these reasonable interpretations is correct:
input |> object.method(#, x, y);
input |> object.method(x, y, #);
input |> object.method(x, y)(#);
<td>
object.method(input, x, y);
object.method(x, y, input);
object.method(x, y)(input);
<tr>
<td>
And this example’s ambiguity would be even worse:
input |> await object.method(x, y);
// 🚫 Syntax Error:
// Topic-style pipeline step
// `|> await object.method(x, y)`
// binds topic but contains
// no topic reference.
…were it not an invalid topic-style pipeline.
<td>It could reasonably mean any of these lines:
await object.method(input, x, y);
await object.method(x, y, input);
await object.method(x, y)(input);
(await object.method(x, y))(input);
<tr>
<td>
So the developer must clarify their intent using one of these lines:
input |> await object.method(#, x, y);
input |> await object.method(x, y, #);
input |> await object.method(x, y)(#);
input |> (await object.method(x, y))(#);
<td>
await object.method(input, x, y);
await object.method(x, y, input);
await object.method(x, y)(input);
(await object.method(x, y))(input);
<tr>
<td>
Both the head and the steps of a pipeline may contain nested inner pipelines.
x = input
|> f(x =>
# + x |> g |> # * 2)
|> #.toString();
However, just as with any other syntax, nested pipelines can quickly become complicated if not used judiciously; they are discouraged otherwise.
<td>A nested pipeline works consistently. It merely shadows the outer context’s topic with the topic within its own steps’ inner contexts.
{
const $ = input;
x = f(x =>
g($ + x) * 2
).toString();
}
<tr>
<td>
x = input
|> # ** 2
|> f(x => #
|> g(#, x)
|> [# * 3, # * 5]);
<td>
{
const $ = input ** 2;
x = f(x => {
const _$ = g($, x);
return [_$ * 3, _$ * 5];
});
}
<tr>
<td>
Currently, four kinds of statements cannot use an outside context’s topic in their expressions. These are:
function
definitions (including those for async functions, generators, and async generators; but not arrow functions, as explained above),class
definitions,for
andwhile
statements,catch
clauses (but see Additional Feature TS), andwith
statements.
x = input |> function () { return #; };
// 🚫 Syntax Error:
// Lexical context `function () { return #; }`
// contains a topic reference
// but has no topic binding.
// 🚫 Syntax Error:
// Pipeline step `|> function () { … }`
// binds topic but contains
// no topic reference.
This behavior is in order to fulfill the goals of simple scoping and of “don’t shoot me in the foot”: it prevents the origin of any topic from being difficult to find. It also fulfills the goal of forward compatibility with future additional features.
However, this behavior is subject to change, depending on feedback after the proposal is implemented in the Babel plugin.
<td> <tr> <td>x = input |> class { m: () { return #; } };
// 🚫 Syntax Error:
// Pipeline step `|> class { … }`
// binds topic but contains
// no topic reference.
<td>
<tr>
<td>
x = input
|> await f(#, 5)
|> () => {
if (#)
return # + 30;
else
return #;
}
|> g;
Any other nested blocks may contain topic references from outer lexical
environments. These include arrow functions, if
statements, try
statements and their finally
clauses (though not their catch
clauses),
switch
statements, and bare block statements.
x = g(await f(input, 5) + 30);
<tr>
<td>
A function definition that is a pipeline step may contain topic references in its default parameters’ expressions, because their scoping is similar to that of the outside context’s: similar enough such that also allowing topic references in them would fulfill the goal of simple scoping. However, as stated above, the function body itself still may not contain topic references.
value
|> processing
|> function (x = #) { return x; }
<td>
function (x = processing(value)) {
return x;
}
<tr>
<td>
The same applies to the parenthesized antecedents of for
and while
loops.
input
|> process
|> (x, y) => {
for (const element of #)
…
}
input
|> process
|> (x, y) => {
let element;
while (element = getNextFrom(#))
…
}
<td>
(x, y) => {
for (const element
of process(input))
…
}
(x, y) {
let element;
while (element =
getNextFrom(input))
…
}
</table>
Real-world examples
Additional features
This document is an explainer for the formal specification of a proposed
smart pipe operator |>
in
JavaScript, along with several other additional features. The specification
is divided into one Stage-0 Core Proposal plus six mutually
independent-but-compatible Additional Features.
The Core Proposal is currently at Stage 0 of the TC39 process and is planned to be presented, along with a competing proposal, to TC39 by Daniel "littledan" Ehrenberg of Igalia.
There are also additional features are not part of the Stage-0 Core Proposal. They are included to illustrate possible separate follow-up proposals for the case in which the Core Proposal advances past Stage 1. Together, the Core Proposal and the additional features demonstrate a unified vision of a future in which composition, partial application, method extraction, and error handling are all tersely expressible with the same simple pipeline/topic concept.
Name | Status | Features | Purpose |
---|---|---|---|
Core Proposal | Stage 0 | Infix pipelines … |> … <br>Lexical topic # | Unary function/expression application |
Additional Feature BC | None | Bare constructor calls … |> new … | Tacit application of constructors |
Additional Feature BA | None | Bare awaited calls … |> await … | Tacit application of async functions |
Additional Feature BP | None | Block pipeline steps … |> {…} | Application of statement blocks |
Additional Feature PF | None | Pipeline functions +> | Partial function/expression application<br>Function/expression composition<br>Method extraction |
Additional Feature TS | None | Pipeline try statements | Tacit application to caught errors |
Additional Feature NP | None | N-ary pipelines (…, …) |> … <br>Lexical topics ## , ### , and ... | N-ary function/expression application |
Legacy link anchors
This explainer used to be a single long document before it was split up into separate appendices. These sections are to point links to subsections of the older versions of the explainer—toward the new appendices.
Core Proposal real-world examples
WHATWG Fetch Standard (Core Proposal only)
See [WHATWG Fetch + CP][].
jQuery (Core Proposal only)
See jQuery + CP.
Underscore.js (Core Proposal only)
See Underscore.js + CP.
Lodash (Core Proposal only)
See Lodash + CP.
Smart pipe style
See core syntax.
Bare style
Topic style
Additional Feature BC
Additional Feature BA
Additional Feature BP
WHATWG Fetch Standard (Core Proposal + Additional Feature BP)
jQuery (Core Proposal + Additional Feature BP)
Lodash (Core Proposal + Additional Feature BP)
Additional Feature TS
Additional Feature PF
Ramda (Core Proposal + Additional Feature BP+PF)
WHATWG Streams Standard (Core Proposal + Additional Features BP+PP+PF)
Additional Feature NP
Lodash (Core Proposal + Additional Features BP+PP+PF+NP)
Ramda (Core Proposal + Additional Features BP+PF+NP)
WHATWG Streams Standard (Core Proposal + Additional Features BP+PP+PF+NP)
Goals
See Goals.
“Don’t break my code.”
Backward compatibility
Zero runtime cost
See [Zero runtime cost][].
Forward compatibility
“Don’t shoot me in the foot.”
See “Don’t shoot me in the foot”.
Opt-in behavior
See Opt-in behavior.
Simple scoping
See Simple scoping.
Static analyzability
See Static analyzability.
“Don’t make me overthink.”
See “Don’t make me overthink”.
Syntactic locality
See Syntactic locality.
Semantic clarity
See Semantic clarity.
Expressive versatility
Cyclomatic simplicity
“Make my code easier to read.”
See “Make my code easier to read”.
Untangled flow
See [Untangled flow][].
Distinguishable punctuators
See Distinguishable punctuators.
Terse parentheses
See Terse parentheses.
Terse variables
See Terse variables.
Terse function calls
See Terse function calls.
Terse composition
See Terse composition.
Terse partial application
See Terse partial application.
Other Goals
See Other Goals.
Conceptual generality
Human writability
See Human writability.
Novice learnability
See Novice learnability.
Relations to other work
Pipelines in other programming languages
Topic references in other programming languages
See Topic references in other programming languages.
do
expressions
See do
expressions.
Function binding
See Function binding.
Function composition
See Function composition.
Partial function application
See Partial function application.
Optional catch
binding
Pattern matching
See Pattern matching.
Block parameters
See Block parameters.
do
expressions
See do
expressions.
Explanation of nomenclature
See Nomenclature.
Term rewriting
See Term rewriting.
[Unix pipe]: https://en.wikipedia.org/wiki/Pipeline_(Unix
[untangled flow]: ./goals.md#untangled-flow
[Visual Basic’s select
statement]: https://docs.microsoft.com/en-us/dotnet/visual-basic/language-reference/statements/select-case-statement
[WebKit console variables]: https://webkit.org/blog/829/web-inspector-updates/
[WHATWG Fetch + CP]: ./core-real-examples.md#whatwg-fetch-standard
[WHATWG Fetch Standard]: https://fetch.spec.whatwg.org/
[WHATWG Streams + CP + BP + PF + NP]: ./additional-feature-np.md#whatwg-streams-standard-core-proposal--additional-features-bppfmt
[WHATWG Streams + CP + BP + PF]: ./additional-feature-pf.md#whatwg-streams-standard-core-proposal--additional-feature-bppf
[WHATWG Streams Standard]: https://stream.spec.whatwg.org/
[WHATWG-stream piping]: https://streams.spec.whatwg.org/#pipe-chains
[Wikipedia: term rewriting]: https://en.wikipedia.org/wiki/Term_rewriting
[zero runtime cost]: ./goals.md#zero-runtime-cost