Comments (16)
If we were to add it, I would call it Optional
and the nil case would be undefined
, not null
.
I've been wanting this type since I started using TypeScript. I also initially found it surprising that type Foo = number?
didn't work. However, I agree with @BendingBender. The only way it makes sense is for it to be a built-in. Without, it's just a type that saves a few characters in favor decreased usability and readability. It's only useful if everyone uses the same naming and everyone knows what it means. That can only happen if it's a built-in type. Another thing that could happen if it was a built-in is syntax sugar like type Foo = number?
.
I would strongly encourage you to open an issue on TypeScript about adding this type.
from type-fest.
I have reconsidered and I think we should add this. While I wouldn't recommend using it in reusable packages, and I think we should clearly discourage it for open source projects, it can be a nice utility for large internal projects where everyone knows what it means. It would also be nice to have it here as an example on how to implement it correctly. And it can be a good way to push TypeScript to add it if more people are exposed to its usefulness and start using it in their code.
I think we should go for:
type Optional<T> = NonNullable<T> | undefined;
Alternatively: (Which inlines NonNullable
without the undefined
exclusion)
type Optional<T> = T extends null ? never : (T | undefined);
Opinions on which? I'm leaning towards the latter.
If you wanna do a PR for this, please read https://github.com/sindresorhus/type-fest/blob/master/.github/contributing.md thoroughly and look at previous PR additions.
from type-fest.
@CarsonF Including null
is not going to happen for reasons outlined here.
from type-fest.
FWIW I like
type Nullable<T> = T | null | undefined;
Which is just the exact opposite of NonNullable
.
I typically don't mind having the type as null
or undefined
because those are usually handled the same way. My use case is this:
const upper = (str: Nullable<string>) => str ? str.toUpperCase() : null;
interface Obj {
foo?: string;
bar: string | null;
}
const obj: Obj;
upper(obj.foo);
upper(obj.bar);
from type-fest.
@EladBezalel What about null
?
@sindresorhus Too trivial?
from type-fest.
I'd make a separate type Nullable<T>
from type-fest.
Sorry about this but when I think about a Maybe
type I have usually something in mind that resembles the functional variant of it, also called Optional
.
Any ideas for a less overloaded name?
from type-fest.
And just looking at the type, it is so trivial that it actually sacrifices readability in favor of saving a few keystrokes. Now, everyone reading this has to look it up instead of directly and unambiguosly understand it.
This is a clear NAK from my side. @sindresorhus has the final word on it.
from type-fest.
As far as i see it it's very self explanatory, once you find out that type you understand it and use it.
As for the naming i wanted something that implies - you either get T or get nothing
That's why i thought Maybe T is really readable
from type-fest.
I use a Maybe as a result type for quite a few of my utility functions that are designed to return undefined if certain conditions aren't met. I usually define it as type Maybe<T> = NonNullable<T> | undefined
to explicitly note that a null value is not an acceptable response.
It's all semantics, of course, but for result types I prefer Maybe
, while using Optional
for input values.
from type-fest.
Thanks for the link. I know what I'll be thinking about the rest of the day 😉
from type-fest.
Has this happened?
from type-fest.
The issue is still open.
from type-fest.
@sindresorhus didn't you outline your own thoughts on this here:
What else is there to do?
from type-fest.
What else is there to do?
The actual work.
The issue is accepted, but someone has to take the time to write a description, high-quality docs, examples, etc.
from type-fest.
@BendingBender
There is the Nullish operator in JS which makes no distinction between "undefined" and "null".
Optional: should only mean it can be defined or not (undefined)
Nullable means it is always defined, but we might want to explicitly have nothing as a value.
Metaphor: I have received no letter (undefined) vs I've received an empty letter (null), both are different concept, but the outcome is still "I've nothing to read", this is precisely why we (sadly) don't really pay attention to either one or the other.
Therefore (#318):
type Nullish = undefined | null;
type MaybeNullish<T> = T | Nullish;
or
Maybe<Nullable<T>>
from type-fest.
Related Issues (20)
- Why do we need to specify the `engines` field in package.json? HOT 1
- Require exactly one key of type `string` HOT 1
- Bug: Nextjs and type-fest camel-case.d.ts Type error: '?' expected.
- `JsonValue` can receive `type` but not `interface` HOT 1
- CamelCasedObjectDeep breaks tuple-types into array-types
- `UnionToUnorderedTuple` type HOT 2
- `NonEmptyObject` fails for objects with dynamic properties HOT 2
- Proposal: `ValueOfDeep<Type, 'key.deepKey'>` HOT 1
- Questions about the types located in the file `/source/basic.d.ts`
- ReadonlyDeep: add test for function or method returning an object? HOT 1
- `RepeatString` type
- `ArraySlice` should support spread array HOT 3
- TS 5.4.2 breaks `ConditionalKeys` and `SetParameterType` HOT 16
- `ReadonlyDeep` / `WritableDeep` not modifying arrays as of TS 5.3.3 HOT 3
- Run `tsc` on all test files HOT 25
- Set up dependabot / renovate HOT 2
- IfAny circular constraint in TS 5.4+ HOT 2
- Make the second argument to RequireAllOrNone optional HOT 1
- Use `NoInfer`?
- Type for serializable objects? HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from type-fest.