The TSConfig Cheat Sheet

  Рет қаралды 32,734

Matt Pocock

Matt Pocock

Күн бұрын

00:00 Intro
00:29 Base Options
01:30 Strictness
02:05 Transpiling With TypeScript?
03:55 Running in the DOM
04:22 Building for Libraries
04:29 Building in a monorepo
05:13 Outro
www.totaltypescript.com/tscon...
Become a TypeScript Wizard with my free beginners TypeScript Course:
www.totaltypescript.com/tutor...
Follow Matt on Twitter
/ mattpocockuk
Join the Discord:
mattpocock.com/discord

Пікірлер: 90
@tsuyoshi4226
@tsuyoshi4226 8 ай бұрын
The tsconfig file has always been one of the hardest parts to figure out in TypeScript. Thank you for your explanation.
@uziboozy4540
@uziboozy4540 8 ай бұрын
What..? Their documentation literally explains every option...
@chimobijustice
@chimobijustice Ай бұрын
Hi guys anyone had ideas or idea of what app matt used for recording thanks 😊
@guillaume5623
@guillaume5623 8 ай бұрын
This is gold, really some options I missed. Thank you
@AlexandreMoreauLemay
@AlexandreMoreauLemay 8 ай бұрын
Super useful! Thanks Matt!
@cedi2929
@cedi2929 8 ай бұрын
That is exactly what I need right now. Thank you Matt! 😊
@pablom8854
@pablom8854 8 ай бұрын
yep me too 😋
@Alivezombie16
@Alivezombie16 8 ай бұрын
So useful! I'd also love a short one on jsx options
@totetoBT
@totetoBT 8 ай бұрын
Great stuff! Can you also do follow-up video on these video on using tsconfig for monorepos? For example what properties should go in the root config, what in some shared config and what config for the lib/apps themselves.
@compton8301
@compton8301 8 ай бұрын
This! 🔥
@austinmudd6372
@austinmudd6372 5 ай бұрын
Second
@jacoblockwood4034
@jacoblockwood4034 8 ай бұрын
Thanks, I never know what to put in the TSConfig when I'm making libraries and always seem to screw one of those up. Will be referring to this over and over again!
@re.liable
@re.liable 5 ай бұрын
Got this recommended to me again. What a huge boon. This should be at the start of every TS tutorial. Thank you for making our lives easier EDIT: I made a comment about tsx (executable not JSX!) but I didn't realize you also mentioned it here! My bad. But seriously though that little gem has eluded me for sooo long but it's so helpful. I don't think I've seen much discussion about it (I always see ts-node). Or maybe there are but they're just not showing because of how unfortunately named it is 😅
@serhiimamedov
@serhiimamedov 5 ай бұрын
Thank you for your work. Very helpful!
@Daranix
@Daranix 8 ай бұрын
this video is gold.
@ofadiman
@ofadiman 8 ай бұрын
Thanks for the video 👍
@sandrinjoy
@sandrinjoy 8 ай бұрын
Thanks Matt, I was literally struggling to copy some random tsconfig file for my side project right now.
@deadlyecho
@deadlyecho 8 ай бұрын
One of the main reasons I hate TS is the config file nightmare 😂😂
@SimonCoulton
@SimonCoulton 8 ай бұрын
Shared with the engineering team, thanks Matt, this is great
@pablom8854
@pablom8854 8 ай бұрын
THANK YOU
@captainnoyaux
@captainnoyaux 8 ай бұрын
Amen on the strict: true it's been my recommendation for years now ! 😂😂😂 Hopefully more and more people adopt it
@jeromealtariba7339
@jeromealtariba7339 8 ай бұрын
always using webpack together with babel to transpile, using tsc as the commande to transpile. Seems to me the most complete way to target most of the bowser's release
@Shpitzick
@Shpitzick 8 ай бұрын
Instant click, this is such a pain point. I'm always clueless about it every time I start a new TS project lol
@StephenRayner
@StephenRayner 6 ай бұрын
This is useful
@JaredFL
@JaredFL 8 ай бұрын
Thanks, tsconfig is a big pain in monorepos.
@branislavbrincko7237
@branislavbrincko7237 8 ай бұрын
I’ve been digging into the tsconfig extensively during last couple of days and your cheatsheet has been very important source of information. I’ve got couple of questions though: 

 The main question: 
 Why do we need to set options for things that seem to be related to compilation via Typescript compiler when we DON’T use Typescript for compilation? What I mean - 
target “Sets the JavaScript language version for emitted JavaScript”. I understand that this applies when using Typescript for compilation. When NOT USING Typescript for compilation, (for example when using Next.js), why do I need target to be set?
Similar with modules - it determines the module system for emitted JS when using Typescript compiler (at least in my understanding). Again, why do I need this when Next.js/SWC does compilation? 

 Side questions: 
 - “skipLibCheck” should be “true” so the .d.ts files in node_modules won’t be checked - if I have exclude: [‘node_modules’], do I still need this? - when using allowJs, do you recommend checkJS or not?
@mattpocockuk
@mattpocockuk 8 ай бұрын
"target": You're absolutely right. I think you've caught a bit of faulty logic on my part. There's no practical reason why you should be setting target if you're not bundling. But if you don't set "target" you HAVE to set "lib" so TS knows what version of ES you're targeting. 1. RE: exclude: ['node_modules'], yes. 2. It's fine, you can use it or not. The key is if you're actually using JSDoc annotations inside .js files, then you MUST enable it.
@branislavbrincko7237
@branislavbrincko7237 8 ай бұрын
​@@mattpocockuk so that means we can simply leave "target" out in Next.js (with proper lib" option set), correct? And what about "module", can we leave it out as well?
@abdallahm96
@abdallahm96 8 ай бұрын
This is my experience, it's useful if you're transpiling the ts through a bundler, some plugins will either ask for options similar to compilerOptions, but will also allow you to specify path to your tsconfig file and read your options from there.
@mattpocockuk
@mattpocockuk 8 ай бұрын
@@branislavbrincko7237 Chatted to a member of the TS team about this and it's basically recommended to always specify target. Inferring it from "lib" is sometimes a bit dodgy, and other tools sometimes depend on reading a specific "target" value.
@jonathangamble
@jonathangamble 8 ай бұрын
Would be interesting to look at config files for sveltekit, next, vue etc
@RayAndrewsDev
@RayAndrewsDev 8 ай бұрын
For all the times I've been crying internally "SOMEBODY just tell me what to set in this *!_^$#*@# FILE" - Bless you sir !
@driden1987
@driden1987 8 ай бұрын
Looks like I'm doing some things incorrectly in my config, thanks Matt!
@danielgilleland8611
@danielgilleland8611 7 ай бұрын
For anyone who get the "error TS1286: ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.", you just need to make sure that the package.json has "type":"module" set.
@hugodsa89
@hugodsa89 8 ай бұрын
You are not the hero we deserved but better
@abdallahm96
@abdallahm96 8 ай бұрын
Kind of new to typescript, what do you think of useUnknownInCatchVariables?
@user-by3rb1xm5x
@user-by3rb1xm5x 8 ай бұрын
Nice video. I also think that strict: true is must have. But what i dont understand is why for exampl nest.js is not strict by default. Any explanation for that?
@LaraRaoof-gy7nz
@LaraRaoof-gy7nz 2 ай бұрын
God bless u
@lengors7327
@lengors7327 8 ай бұрын
If I'm building a library/framework that I want to be used by projects that can be run in either node or browser (and I want different behavior from it based on that), what do you recommend I set `lib` option to? Include `dom` and `dom.iterable` and then do runtime checks if they are available?
@mattpocockuk
@mattpocockuk 8 ай бұрын
Yep, exactly.
@lengors7327
@lengors7327 8 ай бұрын
@@mattpocockuk Thank you :). Love the vids :P
@Vesper123561
@Vesper123561 8 ай бұрын
Do you have any tips on migrating a legacy code base to strict mode? I have tried an eslint plugin and a TS plugin with not desireable result (the TS plugin had a tendency to kill the TS server)
@mateogomez-randulfe7394
@mateogomez-randulfe7394 15 күн бұрын
What do you recommend for setting up path aliases with nodenext?
@abrahamolaobaju1781
@abrahamolaobaju1781 Ай бұрын
are some of these needed when using tsup ?
@mzhomie8880
@mzhomie8880 5 ай бұрын
Is there any list which "lib" version like "es2022" is available and supported by bun?
@Ivan-Bagrintsev
@Ivan-Bagrintsev 7 ай бұрын
Matt! I'm trying to make a wrapper over a wrapper (over a wrapper...) over some data storage. A link to a playground with a very simplified version will be in the comments. When I return the inner wrapper, autocomplete and everything works fine. When I add a default value, the result is the same. When I try to use the default value inside a wrapper, TypeScript throws errors because it sees the union and not the exact wrapper type. I would appreciate it if you could show me how to convince TS that everything is ok (without using "as")
@mattpocockuk
@mattpocockuk 7 ай бұрын
mattpocock.com/discord is the place to ask this!
@nomadshiba
@nomadshiba 8 ай бұрын
i dont add "lib" and "types" inside the tsconfig, instead: - i make an `env.d.ts` - for libs i use `/// ` and others stuff in the file - and for types, i just import them, like: `import "@total-typescript/ts-reset"`, `import "bun-types"` and stuff this ^ way i can just copy paste tsconfig files. because everything environment specific are inside `env.d.ts` now also i use these a lot too: "noUncheckedIndexedAccess": true, "noPropertyAccessFromIndexSignature": true, "exactOptionalPropertyTypes": true
@nicolasdb2497
@nicolasdb2497 8 ай бұрын
For monorepo, do you also add declaration:true? Or this is only for « simple » library?
@mattpocockuk
@mattpocockuk 8 ай бұрын
Yep, you do
@DavidFerreiraG
@DavidFerreiraG 4 ай бұрын
So, are the options of "If transpiling with TypScript" (moduleResolution, module, outDir, sourceMap) no needed if the transpiling is done by esbuild instead of tsc? I have a Vite (v5) project and I want to know if I should add or not those options.
@mattpocockuk
@mattpocockuk 4 ай бұрын
Correct. Vite does the transpilation.
@StyleShit
@StyleShit 8 ай бұрын
Don't you need the `composite` only when using `references`? Or am I missing something?
@ThePouetman
@ThePouetman 7 ай бұрын
I would love a video on the mess that is JSX, i know thay when i was looking into it it was really hard to understand what was foing on.
@mattpocockuk
@mattpocockuk 7 ай бұрын
What were you confused about?
@ThePouetman
@ThePouetman 7 ай бұрын
@@mattpocockuk I was trying to use jsx to make UI for a game without a library so I ended up with some edge cases, but the jsx option in ts config was confusing with jsxFactory and jsxFragmentFactory. In the end it wasn't too bad but it gets more complicated when trying to set it up with a bundler. It gets worse when trying to make the JSX.d.ts with , importing types in a d.ts file and declaring the correct types for JSX.Element and JSX.IntrisicElement. it was a good exercise to understand how the sausage is made but a confusing one at the beginning
@f1ct1ve
@f1ct1ve 8 ай бұрын
I think it's worth noting that none (?) of the Rust/Go based bundlers (SWC, tsup/esbuild) support emitting declaration maps, which makes building libraries with these tools a bit annoying in a mono repo setting, for the reason you mentioned with go to reference. If anyone knows how to get declarationMap to work with a fast bundler, please educate me.
@mattpocockuk
@mattpocockuk 8 ай бұрын
When isolatedDeclarations lands in TypeScript, this will let library developers outsource the creation of declaration files and declaration maps to esbuild/swc. That'll be massive for the ecosystem, and solve the problem you're having.
@f1ct1ve
@f1ct1ve 8 ай бұрын
@@mattpocockuk Is there any timeframe for when this will happen? I've spent day and night the past weeks trying to set up my "perfect" monorepo in TypeScript with pnpm, Turbo, tsup, ts-node with swc, all the cool stuff. I've been back and forth between different setups, and finally thought I had the perfect one. Then I discovered this quirk with the bundlers and I went back to just importing directly from src. While I have you here, I just wanted to say that you've been a huge inspiration for me the past year. Ironically your two latest videos (this one and the one about .js extensions) landed just days after I came to the same conclusions. I'm pretty confident now that I have a good setup, "backed" up by one of the leading figures in the ecosystem. Thank you!
@mble
@mble 7 ай бұрын
Is there any tool that does that automatically with sane defaults?
@alexandrepereira6522
@alexandrepereira6522 8 ай бұрын
What options would you recommend when using tsc solely to type check a JS repo that uses JSDoc?
@mattpocockuk
@mattpocockuk 8 ай бұрын
"checkJS": true, "noEmit": true, "moduleResolution": "NodeNext", "module": "NodeNext",
@alexandrepereira6522
@alexandrepereira6522 8 ай бұрын
Thanks a lot. You’re a legend ❤️
@Mitsunee_
@Mitsunee_ 8 ай бұрын
what does "moduleResolution":"bundler" even do? Last time I messed around with that this option did not exist.
@totetoBT
@totetoBT 8 ай бұрын
Having decalarationMap didn't help my VSCode to navigate to the actual source code and not to the build .d.ts files 😬 Help on this?
@mattpocockuk
@mattpocockuk 8 ай бұрын
Would need more info. Head to mattpocock.com/discord and we'll help out.
@alitabrizian5535
@alitabrizian5535 5 ай бұрын
declarationMap didn't work in our Monoreo project.
@mattpocockuk
@mattpocockuk 5 ай бұрын
Could you elaborate?
@edgeeffect
@edgeeffect 4 ай бұрын
Numpty award for the day... when I tried to cut-n-paste an option off of the screen! :/
@shreyasjejurkar1233
@shreyasjejurkar1233 8 ай бұрын
incrementalCompilation? Missed?
@mattpocockuk
@mattpocockuk 8 ай бұрын
I'm not sure it's a sensible default, I've been bitten by the cache a few times.
@ColinRichardson
@ColinRichardson 8 ай бұрын
I still want a way to say "Here is a string that is the content of a typescript file, strip it of all the typescript type system, and return the valid javascript" method or process.. Rather than point TSC at a file, and it create another file somewhere else.. I want a string in, string out... Still waiting for this to happen..
@mattpocockuk
@mattpocockuk 8 ай бұрын
Pretty sure esbuild exports a function that can do this very bloody fast.
@ColinRichardson
@ColinRichardson 8 ай бұрын
@@mattpocockuk !!!! Wizard... Hunting for it now.. !!!!
@dasten123
@dasten123 8 ай бұрын
Isn't that how Bun runs .ts files? Maybe you can use that somehow
@ColinRichardson
@ColinRichardson 8 ай бұрын
@@mattpocockuk This is looking very promising.. I haven't worked out how to pass a file content 'in' yet as a string, but I can atleast use 'write: false' to have the content.. Only thing worrying me now is it's turning some of my numbers from `-0.005` into `-5e-3` which, I guess works, just looks ugly as hell
@mattpocockuk
@mattpocockuk 8 ай бұрын
@@ColinRichardson That must be configurable. Babel can also do this, as well as swc. I'm sure something will work.
@illyias
@illyias 8 ай бұрын
JavaScript has many problems, but all the damn config files are definitely one of its worst
@ColinRichardson
@ColinRichardson 8 ай бұрын
Don't teach people to cheat! PS: I still need your head size.
@QwDragon
@QwDragon 8 ай бұрын
noUnusedLocals and noUnusedParameters - should be turned off - you have eslint for that. noUncheckedIndexedAccess - is turned off on perpoise and you don't need to turn it on. exactOptionalPropertyTypes - not covered in the video, you should turn it on. Also explanations in video are unclear - didn't get anything new from it.
@TobiWittwer
@TobiWittwer 7 ай бұрын
What are your arguments against noUncheckedIndexedAccess? Just curious, as we're currently thinking about activating it.
@gosnooky
@gosnooky 8 ай бұрын
I never use strict: true - it gets in the way, and I know what's gonna be nullish or not in my codebase 😜
@mattpocockuk
@mattpocockuk 8 ай бұрын
Oh my lord
@dannyisrael
@dannyisrael 8 ай бұрын
Strict false 😅
@mattpocockuk
@mattpocockuk 8 ай бұрын
Eek
Infer is easier than you think
13:38
Matt Pocock
Рет қаралды 86 М.
Most React devs don’t understand generic components
5:43
Matt Pocock
Рет қаралды 46 М.
OMG😳 #tiktok #shorts #potapova_blog
00:58
Potapova_blog
Рет қаралды 3,8 МЛН
Мы никогда не были так напуганы!
00:15
Аришнев
Рет қаралды 4 МЛН
Increíble final 😱
00:37
Juan De Dios Pantoja 2
Рет қаралды 110 МЛН
Конфигурация для TypeScript - tsconfig.json
27:58
Михаил Непомнящий
Рет қаралды 16 М.
This Should Have Been In CSS Years Ago
1:57
Dev Dive In
Рет қаралды 33 М.
Rust for TypeScript devs : Borrow Checker
8:49
ThePrimeagen
Рет қаралды 215 М.
Most TS devs don't understand 'satisfies'
4:10
Matt Pocock
Рет қаралды 53 М.
The Truth about Rust/WebAssembly Performance
29:47
Greg Johnston
Рет қаралды 173 М.
8 TypeScript Tips To Expand Your Mind (and improve your code)
10:54
This Is One Of My Favorite TypeScript Features
5:22
Web Dev Simplified
Рет қаралды 131 М.
as const: the most underrated TypeScript feature
5:38
Matt Pocock
Рет қаралды 112 М.
Опасные облака!😱🌩
0:20
Взрывная История
Рет қаралды 3,3 МЛН
小路飞被臭死啦!#海贼王#路飞
0:27
路飞与唐舞桐
Рет қаралды 11 МЛН
Щенок Нашёл Маму 🥹❤️
0:31
ДоброShorts
Рет қаралды 6 МЛН