diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md index f2a8a2f3..d238f4a8 100644 --- a/docs/advanced-usage.md +++ b/docs/advanced-usage.md @@ -300,6 +300,35 @@ steps: - run: npm test ``` +**Restore-Only Cache** + +```yaml +## In some workflows, you may want to restore a cache without saving it. This can help reduce cache writes and storage usage in workflows that only need to read from cache +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v5 + # Restore Node.js modules cache (restore-only) + - name: Restore Node modules cache + uses: actions/cache@v4 + id: cache-node-modules + with: + path: ~/.npm + key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }} + restore-keys: | + ${{ runner.os }}-node- + # Setup Node.js + - name: Setup Node.js + uses: actions/setup-node@v6 + with: + node-version: '24' + # Install dependencies + - run: npm install +``` + +> For more details related to cache scenarios, please refer [Node – npm](https://github.com/actions/cache/blob/main/examples.md#node---npm). + ## Multiple Operating Systems and Architectures ```yaml