In this blog post, we will look into what are entryComponents, why is the purpose of entryComponents, why do we no longer need to use them after Angular Ivy.

With angular 9, there has been a lot of talking going on around entryComponents, and the Angular developers who had not been much aware of entryComponents have now been interested in knowing more about it.

In this blog post, I will try to cover everything that might help you clear up all the thoughts you have around the usage, importance, and the goodbye of 

The best way to start understanding what 

are would be by first trying to understand component renders in Angular and how really does the compiler play a role here.

So just for a visual understanding of what we are talking right now, I have added below a snapshot of the component declarations inside the root module.

Basically, there are two types of component declarations, ones which are included as a reference insides templates, and the other ones which are loaded imperatively.

What does this mean and what is the difference?

When we reference the component inside templates using the component selector, that’s the declarative way of writing components.

Now, the browser doesn’t really understand what 

 means, and therefore compiling it down to what browser would be able to understand is exactly the Angular compiler’s job.

The imperatively written template for, for example, 

const el = document.createElement('app-instruction-card');
const cmp = new AppInstructionCardCmp();

renderComponent(el, cmp);

if(ctx.val !== oldValue) {
  cmp.value = ctx.val;
  oldValue = cmp.value;
  ng.updateView(el, cmp);
}

This creates an element with your component name and registers it with the browser. It also checks for change detection by comparing the old Value with the current value and updates the view accordingly.

We write templates declaratively since the Angular compiler does this rendering bit for us.

Now, this is where we we can introduce ourselves to what entryComponents are!

Before Ivy, Angular would create Ngfactories for all the components declared in the template and as per the NgModule configuration. During the runtime it would enable tree shaking for the components not used. This is why the dynamic components with no Ngfactories could not be rendered and would throw an error like:

 array would then make the factories for these dynamic components available at runtime.

How Angular specifies a component as an entryComponent behind the hood can be in different ways.

Another way of bootstrapping your component can be done using the 

 method wherein we can imperatively define which component to be bootstrapped on the launch of the app in the browser. This is more imperative way to write since you create an element for the component selector and check for change detection.

Using ngDoBootstrap() and using the same imperative code to declare a component bootstraps it and makes it an entry component into the browser.

Now, you’d be wondering that if entryComponents have such a massive role to play in component declaration, why do we as developers see it rarely used? 

As we discussed above, entryComponents are mostly specified in two ways, bootstrapping them or defining them in a router definition. But since these happen under the hood, we hardly notice it. However, when working with dynamic components, or web components in Angular, we explicity define the components as entry Components inside the 

, we can define the component inside this array:

Role of entryComponents in smaller bundle sizes?

Alright, think for a minute. When we declare multiple components inside the declarations array of our modules, does that mean all these components will be included inside the final bundle?

 have a role to play. So the answer first of all to the above question is NO. All declared components aren’t necessarily present in the final produced bundle. It is if they are specified as entryComponents what decides if they’d be present in the produced bundle.

This basically means that all the routable components will be present in the bundle for sure and also the bootstrap component obviously. This would also include the bundles that are declared inside the templates of other components. However, the tree shaking process will get rid of all the unused components with no reference without having to include them inside the package.

 are mostly explicity defined when dealing with dynamic components, like I said before. This is because there needs to be a reference for the compiler to understand that 

, there is no reference for a particular component in the template or router for now, there is a possibility for it to be rendered dynamically when required. The 

takes care of creating this dynamic component for us but we specify this inside the entryComponents array inside NgModule.

If you have worked with dynamic components before, you might have faced an error like:

Coming to the point why entryComponents are no longer required.

Now knowing why need entryComponents, lets discuss a scenario where in we have created a dynamic component and have added it to the entryComponents array.

This basically means that now since we explicitly declared it as an entryComponent, the tree shaker would not prune this component thinking that it doesn’t have a reference in the template. Also, specifying it as an entryComponent would create a component factory for this dynamic component.

 for a particular dynamic component could be added automatically whenever a dynamic component was created to be used. So this would save the developer from specifying it everytime to make sure the compiler knows the component. One more issue with using entry component was referencing the entryComponents declared inside a lazily loaded module. So if a lazy loaded module contains a modal component as an entry component, you’d face an error like 

No component factory found for this component.

 This was because the root injector couldn’t be referenced to create a component factory for the entryComponent. One solution, though not very promising was creating a component resolver factory yourself for a particular entry component inside the lazy loaded module to be able to execute it.

With Angular 9 coming in and Ivy as the new rendering engine

, all the components would be considered as 

 and do not necessarily need to specified inside the entryComponents array.

With Ivy, the components will have locality and this means that dynamically importing these dynamic components will always work regardless of presence of 

This is because NOW, the presence of the @Component decorator would mean that the factories would be generated for this component and this happens due to the 

ngtsc compiler which is like a set of TypeScript transformers 

and these transformers introduce the static properties 

. These static properties are then able to easily access the code required for instantiating a component/module etc.

See the update from the Angular official documentation here:

https://next.angular.io/guide/deprecations#entrycomponents-and-analyz

A demo here shows how entryComponents are no longer required with Angular 9

https://ng-run.com/edit/c8U6CpMLbfGBDr86PUI0

Some more references to be curious about:

In this blog post, we talked about the need of 

array when dealing with dynamic components or web components 

for the components by specifying it in the entryComponents array and the presence of Component decorator provides the code required for the instantiation of the components ensuring that the compiler is aware of the presence of these 

<h1 data-node-type="titlePlaceholder" class="titlePlaceholder">Bye bye, entryComponents?</h1><div data-node-type="summary" class="summary-block">In this blog post, we will look into what are entryComponents, why is the purpose of entryComponents, why do we no longer need to use them after Angular Ivy.</div><figure class="photo figure-position-inline"><img src="https://s3.amazonaws.com/assets.fullstack.io/n/20200508221036259_1_9REwScHkOaGm257-yuENPA.jpeg" attachmentid="a2b64958-7b02-4a0b-bb6f-6b55c5f53765" contenteditable="false" data-width="1125" data-height="796"><div></div></figure><p>With angular 9, there has been a lot of talking going on around entryComponents, and the Angular developers who had not been much aware of entryComponents have now been interested in knowing more about it.</p><p>In this blog post, I will try to cover everything that might help you clear up all the thoughts you have around the usage, importance, and the goodbye of <strong>entryComponents</strong>.</p><h3><a name="introduction">Introduction</a></h3><p>The best way to start understanding what <strong>entryComponents </strong>are would be by first trying to understand component renders in Angular and how really does the compiler play a role here.</p><p>So just for a visual understanding of what we are talking right now, I have added below a snapshot of the component declarations inside the root module.</p><figure class="photo figure-position-null"><img src="https://cdn-images-1.medium.com/max/750/1*Z6AXLAIfZvcH-evx1nrEOg.png" contenteditable="false" data-width="870" data-height="346"><div></div></figure><p>Basically, there are two types of component declarations, ones which are included as a reference insides templates, and the other ones which are loaded imperatively.</p><h4><a name="what-does-this-mean-and-what-is-the-difference?">What does this mean and what is the difference?</a></h4><p>When we reference the component inside templates using the component selector, that’s the declarative way of writing components.</p><p>Something like this:</p><textarea data-iscodemirror="true" data-mode="text/html" data-uniqueid="cm-yCOQU" id="cm-yCOQU">&lt;div class="container advertise"&gt;
  &lt;app-instruction-card [value]="'answer'"&gt;&lt;/app-instruction-card&gt;
&lt;/div&gt;</textarea><p>Now, the browser doesn’t really understand what <code>app-instruction-card</code> means, and therefore compiling it down to what browser would be able to understand is exactly the Angular compiler’s job.</p><p>The imperatively written template for, for example, <code>app-instruction-card</code> would look something like this:</p><textarea data-iscodemirror="true" data-mode="javascript" data-uniqueid="cm-6O844" id="cm-6O844">const el = document.createElement('app-instruction-card');
const cmp = new AppInstructionCardCmp();

renderComponent(el, cmp);

if(ctx.val !== oldValue) {
  cmp.value = ctx.val;
  oldValue = cmp.value;
  ng.updateView(el, cmp);
}</textarea><p>This creates an element with your component name and registers it with the browser. It also checks for change detection by comparing the old Value with the current value and updates the view accordingly.<br>We write templates declaratively since the Angular compiler does this rendering bit for us.</p><p>Now, this is where we we can introduce ourselves to what entryComponents are!</p><blockquote><div data-panel-type="tip" data-panel-position="inline" class="panel panel-type-tip panel-position-inline"><div class="panel-container lolwut"><p><strong>entryComponents</strong> are the type of components which are imperatively loaded or now that we know what imperative loading means, we can say, entryComponents are those which are not referenced inside the template.</p></div></div></blockquote><p>Before Ivy, Angular would create Ngfactories for all the components declared in the template and as per the NgModule configuration. During the runtime it would enable tree shaking for the components not used. This is why the dynamic components with no Ngfactories could not be rendered and would throw an error like:</p><div data-panel-type="error" data-panel-position="inline" class="panel panel-type-error panel-position-inline"><div class="panel-container lolwut"><p>No component factory found for a <code>my-dynamic-component</code></p></div></div><p>Adding the component to the <code>entryComponents</code> array would then make the factories for these dynamic components available at runtime.</p><p>How Angular specifies a component as an entryComponent behind the hood can be in different ways.</p><ul><li><p><strong><em>Bootstrapping the component</em></strong> is one of the ways of declaring entryComponents. This renders the root component inside the DOM when we launch the app in the browser.&nbsp;<br>The bootstrap array inside the NgModule defines this entryComponent and lets the compiler know that this component should be launched onto the browser with the bootstrapping of the application.</p></li></ul><blockquote><p>Another way of bootstrapping your component can be done using the <strong>ngDoBootstrap()</strong> method wherein we can imperatively define which component to be bootstrapped on the launch of the app in the browser. This is more imperative way to write since you create an element for the component selector and check for change detection.</p></blockquote><p>Using ngDoBootstrap() and using the same imperative code to declare a component bootstraps it and makes it an entry component into the browser.</p><ul><li><p>Specifying components in <strong>route definitions<br></strong>This is the other way Angular specifies a component as an entry component. If we look at the routing definitions, we always specify the routable component class in the definitions and this is when the CLI registers all the routable components as entryComponents.</p></li></ul><p>Now, you’d be wondering that if entryComponents have such a massive role to play in component declaration, why do we as developers see it rarely used?&nbsp;<br>As we discussed above, entryComponents are mostly specified in two ways, bootstrapping them or defining them in a router definition. But since these happen under the hood, we hardly notice it. However, when working with dynamic components, or web components in Angular, we explicity define the components as entry Components inside the <strong>entryComponents</strong> array.</p><p>Inside @<strong>NgModule</strong>, we can define the component inside this array:</p><blockquote><p>entryComponents: […]</p></blockquote><h3><a name="role-of-entrycomponents-in-smaller-bundle-sizes?">Role of entryComponents in smaller bundle&nbsp;sizes?</a></h3><p>Alright, think for a minute. When we declare multiple components inside the declarations array of our modules, does that mean all these components will be included inside the final bundle?</p><p>This is where <strong><em>entryComponents</em></strong> have a role to play. So the answer first of all to the above question is NO. All declared components aren’t necessarily present in the final produced bundle. It is if they are specified as entryComponents what decides if they’d be present in the produced bundle.</p><p>This basically means that all the routable components will be present in the bundle for sure and also the bootstrap component obviously. This would also include the bundles that are declared inside the templates of other components. However, the tree shaking process will get rid of all the unused components with no reference without having to include them inside the package.</p><p><strong>EntryComponents</strong> are mostly explicity defined when dealing with dynamic components, like I said before. This is because there needs to be a reference for the compiler to understand that <strong>THOUGH</strong>, there is no reference for a particular component in the template or router for now, there is a possibility for it to be rendered dynamically when required. The <strong>ComponentFactoryResolver </strong>takes care of creating this dynamic component for us but we specify this inside the entryComponents array inside NgModule.</p><p>If you have worked with dynamic components before, you might have faced an error like:</p><figure class="photo figure-position-null"><img src="https://cdn-images-1.medium.com/max/750/1*tRoTKHfb_T--jky0RiF8oA.png" contenteditable="false" data-width="1641" data-height="370"><div></div></figure><h3><a name="coming-to-the-point-why-entrycomponents-are-no-longer-required">Coming to the point why entryComponents are no longer required.</a></h3><p>Now knowing why need entryComponents, lets discuss a scenario where in we have created a dynamic component and have added it to the entryComponents array.<br>This basically means that now since we explicitly declared it as an entryComponent, the tree shaker would not prune this component thinking that it doesn’t have a reference in the template. Also, specifying it as an entryComponent would create a component factory for this dynamic component.</p><p>First, the <strong>entryComponent</strong> for a particular dynamic component could be added automatically whenever a dynamic component was created to be used. So this would save the developer from specifying it everytime to make sure the compiler knows the component. One more issue with using entry component was referencing the entryComponents declared inside a lazily loaded module. So if a lazy loaded module contains a modal component as an entry component, you’d face an error like <code>No component factory found for this component.</code> This was because the root injector couldn’t be referenced to create a component factory for the entryComponent. One solution, though not very promising was creating a component resolver factory yourself for a particular entry component inside the lazy loaded module to be able to execute it.</p><h3><a name="however,">However,</a></h3><p><strong>With Angular 9 coming in and Ivy as the new rendering engine</strong>, all the components would be considered as <code>entering components</code> and do not necessarily need to specified inside the entryComponents array.</p><h3><a name="why?">Why?</a></h3><p>With Ivy, the components will have locality and this means that dynamically importing these dynamic components will always work regardless of presence of <strong>entryComponents</strong> or ANALYSE<em> _FOR </em>_ ENTRY_COMPONENTS.</p><p>This is because NOW, the presence of the @Component decorator would mean that the factories would be generated for this component and this happens due to the <strong>ngtsc compiler which is like a set of TypeScript transformers </strong>and these transformers introduce the static properties <strong>θcmp</strong> and<strong> θfac</strong>. These static properties are then able to easily access the code required for instantiating a component/module etc.</p><p>See the update from the Angular official documentation here:</p><p><a href="https://next.angular.io/guide/deprecations#entrycomponents-and-analyze_for_entry_components-no-longer-required" rel="noopener noreferrer nofollow">https://next.angular.io/guide/deprecations#entrycomponents-and-analyz</a><em><a href="https://next.angular.io/guide/deprecations#entrycomponents-and-analyze_for_entry_components-no-longer-required" rel="noopener noreferrer nofollow">for</a></em><a href="https://next.angular.io/guide/deprecations#entrycomponents-and-analyze_for_entry_components-no-longer-required" rel="noopener noreferrer nofollow">entry_components-no-longer-required</a></p><p>A demo here shows how entryComponents are no longer required with Angular 9</p><p><a href="https://ng-run.com/edit/c8U6CpMLbfGBDr86PUI0" rel="noopener noreferrer nofollow">https://ng-run.com/edit/c8U6CpMLbfGBDr86PUI0</a></p><h3><a name="some-more-references-to-be-curious-about">Some more references to be curious&nbsp;about:</a></h3><ul><li><p><a href="https://next.angular.io/guide/entry-components" rel="noopener noreferrer nofollow">https://angular.io/guide/entry-components</a></p></li><li><p><a href="https://github.com/angular/angular/issues/28977" rel="noopener noreferrer nofollow">https://github.com/angular/angular/issues/28977</a></p></li><li><p><a href="https://github.com/angular/angular/issues/28826" rel="noopener noreferrer nofollow">https://github.com/angular/angular/issues/28826</a></p></li></ul><h1><a name="conclusion">Conclusion</a></h1><p>In this blog post, we talked about the need of <strong>entryComponents </strong>array when dealing with dynamic components or web components <strong><code>before Ivy</code></strong>. However <strong><code>after Ivy</code></strong>, we do not need <strong>NgFactories </strong>for the components by specifying it in the entryComponents array and the presence of Component decorator provides the code required for the instantiation of the components ensuring that the compiler is aware of the presence of these <strong><code>dynamic/web components</code></strong>.</p>

Learn

The newline Guide to Building Your First GraphQL Server with Node and TypeScript

Teach

Amelia Wattenberger

Author of Fullstack D3

Community

Bye bye, entryComponents?

Responses (0)

Masterclasses

Tutorials

Fullstack React with TypeScript