Course contentsShow
← Web Development
Lesson 2948 of 2,98252. Frontend SecurityFree lesson

Lock Files and Dependency Pinning

Use package-lock.json or yarn.lock to ensure consistent installations and prevent unexpected version changes.

Lock Files and Dependency Pinning

What you'll learn: How to use lock files to guarantee consistent, reproducible installations across all environments and prevent unexpected dependency updates.

The Problem: Version Drift

When you run npm install or yarn install, your package manager reads package.json to determine what dependencies to install. However, package.json typically specifies version ranges (like "^1.2.3"), not exact versions. Without a lock file, different machines might install different minor or patch versions, leading to "it works on my machine" problems.

What Lock Files Do

Lock files (package-lock.json for npm, yarn.lock for Yarn) record the exact version of every package installed in your project—including all nested dependencies. Think of it as a detailed receipt that lists not just what you ordered, but the precise brand, batch number, and supplier for every ingredient in your recipe.

When you install dependencies with a lock file present, the package manager installs the exact versions recorded, ensuring everyone on your team (and your CI/CD pipeline) gets identical code.

Why This Matters for Security

Lock files are your defense against:

  • Unexpected version changes that introduce bugs or vulnerabilities
  • Supply chain attacks where a malicious update slips into a dependency
  • Inconsistent behavior between development, staging, and production

Without pinning, an attacker could compromise a package, and your next install would silently pull the malicious version—even if you never changed package.json.

Best Practice

Always commit your lock files to version control. Treat them as sacred: they're your guarantee of reproducibility and a critical security boundary.

Key Takeaway: Lock files (package-lock.json, yarn.lock) freeze exact dependency versions, ensuring consistent installations and protecting against unexpected—and potentially malicious—updates. Always commit them to your repository.