Why it is important to keep the version in sync when using the library component in SharePoint Framework

November 19, 2019

A couple of months ago, I moved a couple of my projects to make use of the library component in SharePoint Framework. The library component allows you to share common logic between your projects. Sharing code through your projects is having many benefits like smaller bundle sizes, more comfortable to fix bugs, no code duplication, …

Information: Official documentation of the library component is available here: Using library component type in SharePoint Framework

Important things to note about the documentation

If you head to the documentation page, it points out a couple of essential things:

  • Only host one library component version at the time
  • Not supported to have other component types
  • Not supported using site collection app catalog

The first point is the most important one, as this could cause issues quickly. You must keep versions in sync. Keeping the version in sync means that whenever you update the library component, project its version number. You need to update to the same version in the projects which depend on this library component.

It is simple enough, but issues could be huge

It is easy to understand that version numbers need to be in sync, but if you accidentally forget it or rollback to an older version. You need to remember also to rollback the library component. The error messages which SharePoint provides do not always makes things clear.

When you accidentally reference an incorrect version in a web part, you see the following message:

Web part with an incorrect version reference
Web part with an incorrect version reference

This message tells you what the issue is. As it points out two things:

  1. It cannot load the component (web part)
  2. Failed to find the manifest of a component (library component) for a specific version

As you probably own both of the projects, it is easy to check the version numbers and fix the issue.

When you are using an Application Customizer, it is a bit different. There you get the following error message (in the browser its console):

Application Customizer issue when referencing incorrect library version
Application Customizer issue when referencing incorrect library version

This was my original issue of where it all started for me. In the above error message, you do not see any reference to the library component, so you might think that SharePoint has an issue with loading the manifest file of your application customizer, which is, of course, not the case. Debugging the SharePoint JS code, you can find out where the issue is coming.

Debugging SP JS code
Debugging SP JS code

By placing a breakpoint on that code and refreshing the page, the breakpoint gets hit twice, first, for the library component and second for the application customizer.

Here is the output of the variable n when it first hits my breakpoint:

Library component loading issue
Library component loading issue

For the library component, there is no error shown in the browser console. The only pointer you have is the application customizer project ID, which might lead you to the wrong path.

Remember: Check if the version of the library component in the package.json file is the same as the dependency version in the package.json files of the depended projects.

Happy coding


comments powered by Disqus