spacer
Skip to content

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 npm version.

@pnp/
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.

"Sharing is Caring"

Please use http://aka.ms/sppnp for the latest updates around the whole SharePoint Patterns and Practices (PnP) program.

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.