Skip to content

TeamsJS Releases

AE ( ͡ಠ ʖ̯ ͡ಠ) edited this page Jan 4, 2024 · 6 revisions

Release Cadence

Official Releases

The goal is that official releases happen monthly on the first Wednesday (Pacific Time) of each month.

Beta releases

Beta versions are published weekly on all Wednesdays where there is not an official release. Beta releases are similar to official releases except:

Release Locations

The TeamsJS package can be consumed either via npm in your build process or via a <script> tag reference to the CDN at runtime.

npm

Official releases and beta releases are both published to the npm feed. However, only an official release is ever marked "latest" on npm. Beta builds are always available via npm , but you have to manually reference them (you can see them on the versions tab.

CDN

Both official and beta releases are published to the CDN, but in different locations. Official releases always live at a URL like this:

https://res.cdn.office.net/teams-js/<VERSION NUMBER>/js/MicrosoftTeams.min.js

You can find the URL for a particular official version in the README for that version (which is shown on the npm page for the version). E.g., for 2.18.0, the README shows:

<script
  src="https://res.cdn.office.net/teams-js/2.18.0/js/MicrosoftTeams.min.js"
  integrity_no="sha384-g8DoRkiR0ECQ9rwKIgY8GjQ5h0d2jp1347CmU/IRlyUHPjJZiFWEOYc+hFtT9MGL"
  crossorigin="anonymous"
></script>

Beta releases are only published to the sdf CDN endpoint, which has a slightly different URL:

https://res-sdf.cdn.office.net/teams-js/<BETA VERSION NUMBER>/js/MicrosoftTeams.min.js

For example, beta release 2.19.0-beta.1 is located here:

https://res-sdf.cdn.office.net/teams-js/2.19.0-beta.1/js/MicrosoftTeams.min.js

Since the README is not updated for beta releases, you will have to hand-craft the CDN URL for them using the pattern shown above.

How do I know which release my teamsjs change is in?

Your change will be in the next release that occurs after your change has been committed. For example, if you committed your change to the main branch on Tuesday of the last week of the month, it will first appear in the beta release the next day (Wednesday) and then appear in the official release on the following week's Wednesday (first week of the month).

See Also

TeamsJS Library Versioning