Home

SharePoint Patterns and Practices Logo

PnPjs is a collection of fluent libraries for consuming SharePoint, Graph, and Office 365 REST APIs in a type-safe way. You can use it within SharePoint Framework, Nodejs, or any JavaScript project. This an open source initiative and we encourage contributions and constructive feedback from the community.

These articles provide general guidance for working with the libraries. If you are migrating from V2 please review the transition guide.

Fluent API in action

Animation of the library in use, note intellisense help in building your queries

Packages¶

Patterns and Practices client side libraries (PnPjs) are comprised of the packages listed below. All of the packages are published as a set and depend on their peers within the @pnp scope.

The latest published version is .


@pnp/
	azidjsclient	Provides an Azure Identity wrapper suitable for use with PnPjs
	core	Provides shared functionality across all pnp libraries
	graph	Provides a fluent api for working with Microsoft Graph
	logging	Light-weight, subscribable logging framework
	msaljsclient	Provides an msal wrapper suitable for use with PnPjs
	nodejs	Provides functionality enabling the @pnp libraries within nodejs
	queryable	Provides shared query functionality and base classes
	sp	Provides a fluent api for working with SharePoint REST
	sp-admin	Provides a fluent api for working with M365 Tenant admin methods

Authentication¶

We have a new section dedicated to helping you figure out the best way to handle authentication in your application, check it out!

Issues, Questions, Ideas¶

Please log an issue using our template as a guide. This will let us track your request and ensure we respond. We appreciate any constructive feedback, questions, ideas, or bug reports with our thanks for giving back to the project.

Changelog¶

Please review the CHANGELOG for release details on all library changes.

Code of Conduct¶

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Please use http://aka.ms/community/home for the latest updates around the whole Microsoft 365 and Power Platform Community(PnP) initiative.

Disclaimer¶

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.