René's URL Explorer Experiment


Title: User-defined type assertions · Issue #17760 · microsoft/TypeScript · GitHub

Open Graph Title: User-defined type assertions · Issue #17760 · microsoft/TypeScript

X Title: User-defined type assertions · Issue #17760 · microsoft/TypeScript

Description: Proposal: support user-defined type assertions (keyword as) in addition to user-defined type guards (keyword is). A user-defined type assertion is a function with a return type expressed as in the following example (continuing the handbo...

Open Graph Description: Proposal: support user-defined type assertions (keyword as) in addition to user-defined type guards (keyword is). A user-defined type assertion is a function with a return type expressed as in the ...

X Description: Proposal: support user-defined type assertions (keyword as) in addition to user-defined type guards (keyword is). A user-defined type assertion is a function with a return type expressed as in the ...

Opengraph URL: https://github.com/microsoft/TypeScript/issues/17760

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"User-defined type assertions","articleBody":"Proposal: support user-defined type assertions (keyword `as`) in addition to user-defined type guards (keyword `is`).\r\n\r\nA user-defined type assertion is a function with a return type expressed as in the following example (continuing the handbook example in \"Advanced Types\").\r\n```ts\r\nfunction assertIsFish(pet: Fish | Bird): pet as Fish {\r\n    if (!isFish(pet))\r\n        throw new Error(\"birds are not supported\");\r\n}\r\n\r\nassertIsFish(pet);\r\n\r\npet.swim();\r\n```\r\n\r\n`:pet as fish` means that, if the function assertIsFish returns without throwing, pet is automatically asserted to be of type `Fish`.\r\n\r\nUse-cases:\r\n\r\n1. Validators: user-defined type assertions make it possible to encapsulate in functions the type narrowing that is currently available through control flow analysis. They also allow types that better describe the behavior of many existing libraries, including: node asserts, data validators that throw detailed errors, many test frameworks.\r\n\r\n2. Polyfills: enables describing functions that modify objects by adding new properties.\r\n```ts\r\naddName\u003cT>(obj: T): obj as T & { name: string } {\r\n    obj.name = \"Mike\";\r\n}\r\n\r\nconst obj = {};\r\naddName(obj);\r\n\r\nobj.name.indexOf(\"i\");\r\n```\r\n\r\nValidator examples:\r\n\r\nsimple undefined checking\r\n```ts\r\nfunction notUndefined\u003cT>(obj: T | undefined): obj as T {\r\n    if (obj === undefined)\r\n        throw new Error(\"invalid object\");\r\n}\r\n\r\nconst myObj: string | undefined = {} as any;\r\n\r\n// [ts] Object is possibly 'undefined'.\r\nmyObj.indexOf(\"\");\r\n\r\nnotUndefined(myObj);\r\n\r\n// no errors\r\nmyObj.indexOf(\"\");\r\n```\r\n\r\n[joi-like](https://github.com/hapijs/joi) validation currently requires implementing the schema description of an object for runtime checking and copying the schema to an interface to have static type checking while the static type could be inferred by the implementation of the schema\r\n```ts\r\ninterface Schema\u003cT> {\r\n    validate(obj: any): obj is T;\r\n}\r\n\r\nfunction attemptValidation\u003cT>(obj: any, schema: Schema\u003cT>): obj as T {\r\n    if (!schema.validate(obj))\r\n        throw new Error(\"very detailed object validation error\");\r\n}\r\n\r\n// complex schema implements T and T is inferred by the schema construction\r\n// this is already possible\r\nconst complexSchema = Joi.object({\r\n    myField: Joi.date().iso()\r\n});\r\n\r\nattemptValidation(objFromTheRealWorld, complexSchema);\r\n\r\nconst day = objFromTheReadWorld.myField.getDay();\r\n```\r\n","author":{"url":"https://github.com/maghis","@type":"Person","name":"maghis"},"datePublished":"2017-08-12T15:45:43Z","url":"https://github.com/microsoft/TypeScript/issues/17760"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:e60f9d68-ef94-3975-33a8-fc0c4ba4719a
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idC31C:34CAB:31BD1BB:3FA5D29:6B01DD5A
html-safe-nonce95ad824006cc1df1c5f2ebe8df86aaf131092dd0b72a82b310693dce8f52d51b
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDMzFDOjM0Q0FCOjMxQkQxQkI6M0ZBNUQyOTo2QjAxREQ1QSIsInZpc2l0b3JfaWQiOiIxNzM4NzY5MDk4NzA5NTIzODAyIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac31f3ee26e43a6a90207ba95aa0dd813cbeb75486ddc06c5c29668566ef64e844
hovercard-subject-tagissue:249819375
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/microsoft/TypeScript/17760/issue_layout
twitter:imagehttps://opengraph.githubassets.com/35299c7d2abc9a7f3d40c16076488cb80d9e0446898d364dea24e8d5ba70a416/microsoft/TypeScript/issues/17760
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/35299c7d2abc9a7f3d40c16076488cb80d9e0446898d364dea24e8d5ba70a416/microsoft/TypeScript/issues/17760
og:image:altProposal: support user-defined type assertions (keyword as) in addition to user-defined type guards (keyword is). A user-defined type assertion is a function with a return type expressed as in the ...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamemaghis
hostnamegithub.com
expected-hostnamegithub.com
Nonecc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c
turbo-cache-controlno-preview
go-importgithub.com/microsoft/TypeScript git https://github.com/microsoft/TypeScript.git
octolytics-dimension-user_id6154722
octolytics-dimension-user_loginmicrosoft
octolytics-dimension-repository_id20929025
octolytics-dimension-repository_nwomicrosoft/TypeScript
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id20929025
octolytics-dimension-repository_network_root_nwomicrosoft/TypeScript
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release8c77c9e8439031ad54c75a250694842892f693e1
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/microsoft/TypeScript/issues/17760#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmicrosoft%2FTypeScript%2Fissues%2F17760
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmicrosoft%2FTypeScript%2Fissues%2F17760
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=microsoft%2FTypeScript
Reloadhttps://github.com/microsoft/TypeScript/issues/17760
Reloadhttps://github.com/microsoft/TypeScript/issues/17760
Reloadhttps://github.com/microsoft/TypeScript/issues/17760
microsofthttps://github.com/microsoft
TypeScripthttps://github.com/microsoft/TypeScript
Codehttps://github.com/microsoft/TypeScript
Issues5k (5k)https://github.com/microsoft/TypeScript/issues
Pull requests312 (312)https://github.com/microsoft/TypeScript/pulls
Actionshttps://github.com/microsoft/TypeScript/actions
Projectshttps://github.com/microsoft/TypeScript/projects
Wikihttps://github.com/microsoft/TypeScript/wiki
Security and qualityhttps://github.com/microsoft/TypeScript/security
Insightshttps://github.com/microsoft/TypeScript/insights
https://github.com/microsoft/TypeScript
New issuehttps://github.com/login?return_to=https://github.com/microsoft/TypeScript/issues/17760
New issuehttps://github.com/login?return_to=https://github.com/microsoft/TypeScript/issues/17760
User-defined type assertionshttps://github.com/microsoft/TypeScript/issues/17760#top
FixedA PR has been merged for this issuehttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Fixed%22
SuggestionAn idea for TypeScripthttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Suggestion%22
TypeScript 3.7.0https://github.com/microsoft/TypeScript/milestone/98
https://github.com/maghis
Massimo Andreasi Bassi (maghis)https://github.com/maghis
on Aug 12, 2017https://github.com/microsoft/TypeScript/issues/17760#issue-249819375
joi-likehttps://github.com/hapijs/joi
https://github.com/jcalz
Joe Calzaretta (jcalz)https://github.com/jcalz
on Aug 14, 2017https://github.com/microsoft/TypeScript/issues/17760#issuecomment-322246015
https://github.com/maghis
Massimo Andreasi Bassi (maghis)https://github.com/maghis
on Aug 14, 2017https://github.com/microsoft/TypeScript/issues/17760#issuecomment-322259085
Joe Calzaretta (@jcalz)https://github.com/jcalz
Mohamed Hegazy (mhegazy)https://github.com/mhegazy
SuggestionAn idea for TypeScripthttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Suggestion%22
Awaiting More FeedbackThis means we'd like to hear from more people who would be helped by this featurehttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Awaiting%20More%20Feedback%22
on Aug 21, 2017https://github.com/microsoft/TypeScript/issues/17760#event-1214973186
https://github.com/mhegazy
Mohamed Hegazy (mhegazy)https://github.com/mhegazy
on Aug 22, 2017https://github.com/microsoft/TypeScript/issues/17760#issuecomment-323889496
#10421https://github.com/microsoft/TypeScript/issues/10421
https://github.com/TazmanianD
TazmanianDhttps://github.com/TazmanianD
on Oct 12, 2017https://github.com/microsoft/TypeScript/issues/17760#issuecomment-336251568
Joe Calzaretta (@jcalz)https://github.com/jcalz
https://github.com/maghis
Massimo Andreasi Bassi (maghis)https://github.com/maghis
on Oct 19, 2017https://github.com/microsoft/TypeScript/issues/17760#issuecomment-337973552
TazmanianDhttps://github.com/TazmanianD
https://github.com/mitchellwills
Mitchell Wills (mitchellwills)https://github.com/mitchellwills
on Oct 22, 2017https://github.com/microsoft/TypeScript/issues/17760#issuecomment-338440908
https://github.com/MicahZoltu
Micah Zoltu (MicahZoltu)https://github.com/MicahZoltu
on May 27, 2018https://github.com/microsoft/TypeScript/issues/17760#issuecomment-392309015
https://github.com/maghis
Massimo Andreasi Bassi (maghis)https://github.com/maghis
on Jun 5, 2018https://github.com/microsoft/TypeScript/issues/17760#issuecomment-394773698
Micah Zoltu (@MicahZoltu)https://github.com/MicahZoltu
https://github.com/MicahZoltu
Micah Zoltu (MicahZoltu)https://github.com/MicahZoltu
on Jun 5, 2018https://github.com/microsoft/TypeScript/issues/17760#issuecomment-394778548
#24436 (comment)https://github.com/microsoft/TypeScript/pull/24436#issuecomment-393911190
https://github.com/maghis
Massimo Andreasi Bassi (maghis)https://github.com/maghis
on Jun 6, 2018https://github.com/microsoft/TypeScript/issues/17760#issuecomment-395077778
Micah Zoltu (@MicahZoltu)https://github.com/MicahZoltu
https://github.com/aciccarello
Anthony Ciccarello (aciccarello)https://github.com/aciccarello
on Jan 28, 2019https://github.com/microsoft/TypeScript/issues/17760#issuecomment-458239062
Massimo Andreasi Bassi (@maghis)https://github.com/maghis
#17760 (comment)https://github.com/Microsoft/TypeScript/issues/17760#issuecomment-322259085
https://github.com/RyanCavanaugh
Ryan Cavanaugh (RyanCavanaugh)https://github.com/RyanCavanaugh
on Jan 28, 2019https://github.com/microsoft/TypeScript/issues/17760#issuecomment-458317050
Anthony Ciccarello (@aciccarello)https://github.com/aciccarello
#10421https://github.com/microsoft/TypeScript/issues/10421
#8655https://github.com/microsoft/TypeScript/issues/8655
https://github.com/ikokostya
ikokostyahttps://github.com/ikokostya
on Jan 29, 2019https://github.com/microsoft/TypeScript/issues/17760#issuecomment-458530273
Ryan Cavanaugh (@RyanCavanaugh)https://github.com/RyanCavanaugh
#8655https://github.com/microsoft/TypeScript/issues/8655
https://github.com/jwalton
Jason Walton (jwalton)https://github.com/jwalton
on Mar 29, 2019https://github.com/microsoft/TypeScript/issues/17760#issuecomment-478135448
https://github.com/mheiber
Max Heiber (mheiber)https://github.com/mheiber
on Jun 4, 2019https://github.com/microsoft/TypeScript/issues/17760#issuecomment-498755410
https://github.com/ethanresnick
Ethan Resnick (ethanresnick)https://github.com/ethanresnick
on Feb 24, 2020https://github.com/microsoft/TypeScript/issues/17760#issuecomment-590197456
#32695https://github.com/microsoft/TypeScript/pull/32695
https://github.com/maghis
Massimo Andreasi Bassi (maghis)https://github.com/maghis
on Mar 27, 2020https://github.com/microsoft/TypeScript/issues/17760#issuecomment-604981544
Daniel Rosenwasser (DanielRosenwasser)https://github.com/DanielRosenwasser
completedhttps://github.com/microsoft/TypeScript/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on Apr 28, 2022https://github.com/microsoft/TypeScript/issues/17760#event-6512254427
https://github.com/DanielRosenwasser
Daniel Rosenwasser (DanielRosenwasser)https://github.com/DanielRosenwasser
on Apr 28, 2022https://github.com/microsoft/TypeScript/issues/17760#issuecomment-1111785518
#32695https://github.com/microsoft/TypeScript/pull/32695
Daniel Rosenwasser (DanielRosenwasser)https://github.com/DanielRosenwasser
TypeScript 3.7.0https://github.com/microsoft/TypeScript/milestone/98
on Apr 28, 2022https://github.com/microsoft/TypeScript/issues/17760#event-6512259809
Daniel Rosenwasser (DanielRosenwasser)https://github.com/DanielRosenwasser
FixedA PR has been merged for this issuehttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Fixed%22
Awaiting More FeedbackThis means we'd like to hear from more people who would be helped by this featurehttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Awaiting%20More%20Feedback%22
on Apr 28, 2022https://github.com/microsoft/TypeScript/issues/17760#event-6512260345
Sign up for freehttps://github.com/signup?return_to=https://github.com/microsoft/TypeScript/issues/17760
Sign in to commenthttps://github.com/login?return_to=https://github.com/microsoft/TypeScript/issues/17760
FixedA PR has been merged for this issuehttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Fixed%22
SuggestionAn idea for TypeScripthttps://github.com/microsoft/TypeScript/issues?q=state%3Aopen%20label%3A%22Suggestion%22
TypeScript 3.7.0https://github.com/microsoft/TypeScript/milestone/98
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.