Deliver web apps with confidence 🚀
Find a file
Paul Gschwendtner d4d76ead80 fix(compiler-cli): do not fail fatal when references to non-existent module are discovered (#58515)
Currently when application source code references e.g. an NgModule that
points to references that aren't available, the compiler will break at
runtime without any actionable/reasonable error.

This could happen for example when a library is referenced in code, but
the library is simply not available in the `node_modules`. Clearly,
TypeScript would issue import diagnostics here, but the Angular compiler
shouldn't break fatally. This is useful for migrations which may run
against projects which aren't fully compilable. The compiler handles
this fine in all cases, except when processing `.d.ts` currently... and
the runtime exception invalides all other information of the program
etc.

This commit fixes this by degrading such unexpected cases for `.d.ts`
metadata reading to be handled gracefully. This matches existing logic
where the `.d.ts` doesn't necessarily match the "expecation"/"expected
format".

The worst case is that the Angular compiler will not have type
information for some directives of e.g. a library that just isn't
installed in local `node_modules`; compared to magical errors and
unexpected runtime behavior.

PR Close #58515
2024-11-06 13:04:22 +01:00
.circleci refactor(docs-infra): complete removal of aio directory (#56496) 2024-06-18 12:26:00 -07:00
.devcontainer refactor(docs-infra): complete removal of aio directory (#56496) 2024-06-18 12:26:00 -07:00
.github build: update all non-major dependencies (#58506) 2024-11-05 08:14:53 +01:00
.husky build: simplify husky setup (#54315) 2024-02-07 16:34:13 +00:00
.ng-dev ci: exclude packages/ssr/BUILD.bazel from requiring a G3 sync (#58514) 2024-11-05 16:36:19 +01:00
.vscode refactor(docs-infra): complete removal of aio directory (#56496) 2024-06-18 12:26:00 -07:00
.yarn build: update yarn to 1.22.22 (#58448) 2024-10-31 19:06:20 +01:00
adev docs: fix example for pipe operator precedence by removing extra parenthesis (#58488) 2024-11-06 07:00:42 +01:00
contributing-docs docs: cover time-based statements in docs authoring guide (#57536) 2024-08-28 08:45:10 -07:00
devtools refactor(devtools): convert to bootstrap application for shell and demo apps (#58319) 2024-11-05 07:35:43 +01:00
goldens refactor(core): tree-shake defer block registry (#58424) 2024-10-31 18:12:03 +01:00
integration test: update protractor builder usage to private-protractor (#58254) 2024-10-22 07:37:14 -07:00
modules refactor(platform-server): replace patch by CLI option. (#58256) 2024-10-21 09:09:07 -07:00
packages fix(compiler-cli): do not fail fatal when references to non-existent module are discovered (#58515) 2024-11-06 13:04:22 +01:00
scripts build: Update publish-build-artifacts to honor ORG (#58408) 2024-11-01 14:41:58 +00:00
third_party build: create NodeJS ESM loader for supporting Bazel setup (#48521) 2022-12-19 19:50:40 +00:00
tools build: remove usages of useDefineForClassFields: false (#58297) 2024-10-28 12:26:06 -07:00
.bazelignore refactor(docs-infra): complete removal of aio directory (#56496) 2024-06-18 12:26:00 -07:00
.bazelrc refactor(docs-infra): rename Bazel flag --prerender_adev to --full_build_adev (#58320) 2024-10-23 08:04:11 -07:00
.bazelversion build: update to bazel v5 for new runfiles API used in dev-infra (#45407) 2022-03-21 16:55:36 -07:00
.clang-format feat(tooling): Add a .clang-format for automated JavaScript formatting. 2015-04-02 08:44:34 -07:00
.editorconfig build: use https link to editorconfig.org in .editorconfig (#27664) 2018-12-18 09:30:09 -08:00
.gitattributes build: cleanup .gitattributes file and remove outdated CRLF attribute (#46513) 2022-06-28 13:38:27 -07:00
.gitignore build: add ignores for aio (#56538) 2024-06-21 10:03:34 -07:00
.gitmessage build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00
.mailmap build: add a Git .mailmap with my new name (#19550) 2017-10-09 14:35:30 -07:00
.npmrc build: rely on engines to prevent using npm for dependency install (#41477) 2021-04-07 12:05:01 -07:00
.nvmrc build: bump to node 18.20 to support v18 (#55162) 2024-04-12 14:51:44 -07:00
.prettierrc build: Update prettierrc to always use trailing commas (#58266) 2024-11-04 18:14:05 +01:00
.pullapprove.yml ci: clean up pullapprove list (#58325) 2024-10-23 07:59:49 -07:00
.yarnrc build: update yarn to 1.22.22 (#58448) 2024-10-31 19:06:20 +01:00
browser-providers.conf.d.ts build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
browser-providers.conf.js refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
BUILD.bazel build: update yarn to 1.22.22 (#58448) 2024-10-31 19:06:20 +01:00
CHANGELOG.md release: cut the v19.0.0-rc.0 release 2024-10-30 13:20:44 -07:00
CHANGELOG_ARCHIVE.md docs: fix typos 2023-06-22 12:56:49 +02:00
CODE_OF_CONDUCT.md build: update CODE_OF_CONDUCT.md to match the content of angular/.github 2023-03-13 21:07:51 +00:00
CONTRIBUTING.md docs: add fork url in contribution guidelines for new contributors (#57837) 2024-09-17 15:23:34 +02:00
gulpfile.js refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
karma-js.conf.js refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
LICENSE refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
package.json build: update babel dependencies (#58499) 2024-11-06 06:59:44 +01:00
packages.bzl refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
README.md docs: use new blog in links of new documentation (#56052) 2024-07-29 13:48:37 -07:00
renovate.json build: migrate config renovate.json (#58503) 2024-11-05 07:51:40 +01:00
SECURITY.md docs: update security guide link to adev (#56469) 2024-06-17 08:54:08 -07:00
tsconfig-tslint.json build: bump to node 18.20 to support v18 (#55162) 2024-04-12 14:51:44 -07:00
tslint.json refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
WORKSPACE build: update io_bazel_rules_sass digest to c375923 (#58477) 2024-11-04 15:37:38 +01:00
yarn.bzl build: update yarn to 1.22.22 (#58448) 2024-10-31 19:06:20 +01:00
yarn.lock build: update babel dependencies (#58499) 2024-11-06 06:59:44 +01:00

Angular - The modern web developer's platform

angular-logo
Angular is a development platform for building mobile and desktop web applications
using TypeScript/JavaScript and other languages.

angular.dev

Contributing Guidelines · Submit an Issue · Blog

CI status   Angular on npm   Discord conversation

InsightsSnapshot


Documentation

Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.

Advanced

Local Development

To contribute to the Angular Docs, check out the Angular.dev README

Development Setup

Prerequisites

Setting Up a Project

Install the Angular CLI globally:

npm install -g @angular/cli

Create workspace:

ng new [PROJECT NAME]

Run the application:

cd [PROJECT NAME]
ng serve

Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.

Quickstart

Get started in 5 minutes.

Ecosystem

angular ecosystem logos

Changelog

Learn about the latest improvements.

Upgrading

Check out our upgrade guide to find out the best way to upgrade your project.

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.

Code of Conduct

Help us keep Angular open and inclusive. Please read and follow our Code of Conduct.

Community

Join the conversation and help the community.

Love Angular badge

Love Angular? Give our repo a star ⬆️.