lodash.first

3.0.0 verified Sat Apr 25 auth: no javascript maintenance

The lodash.first package provides the modern build of lodash's `_.first` function as a standalone npm module, version 3.0.0. This package is part of lodash's modularized approach, allowing developers to import only the specific utility they need, reducing bundle size compared to using the full lodash library. Note that since lodash v4, `_.first` has been deprecated in favor of `_.head`, which offers identical functionality. The modularized packages like lodash.first are frozen at lodash v3.0.0 and are not updated with new releases; they remain in maintenance mode.

Common errors

error Cannot find module 'lodash.first' ↓

cause Package not installed or missing from node_modules.

fix

Run 'npm install lodash.first' in your project directory.

error TypeError: first is not a function ↓

cause Incorrect import style (e.g., default import) or missing require.

fix

Use 'var first = require('lodash.first');' and ensure package is installed.

Warnings

gotcha lodash.first is frozen at v3.0.0 and will not receive updates. Use lodash.head instead for current lodash API. ↓

fix Switch to require('lodash.head') or use the full lodash v4+.

deprecated _.first deprecated in lodash v4 in favor of _.head. ↓

fix Use _.head instead.

breaking In lodash v3, _.first expects an array-like object. Passing a non-array-like (e.g., number) may throw or return undefined. ↓

fix Ensure input is array-like before calling first.

Install

npm install lodash.first

yarn add lodash.first

pnpm add lodash.first

Imports

first
wrong
```
import first from 'lodash.first'
```
correct
```
var first = require('lodash.first')
```
This package only provides a CommonJS require API; ESM import is unsupported. For ES modules, use lodash-es or the full lodash with tree-shaking.
_.first
wrong
```
var first = require('lodash/first')
```
correct
```
var _ = require('lodash'); var first = _.first
```
lodash/first path was not part of lodash v3; use _.first or the standalone package.
head
wrong
```
var first = require('lodash.first')
```
correct
```
var head = require('lodash.head')
```
In lodash v4, _.first is deprecated in favor of _.head. Use head if you want current API.

Quickstart

Demonstrates basic usage of lodash.first to get the first element of arrays, strings, and array-like objects.

var first = require('lodash.first');

// Get first element of an array
console.log(first([1, 2, 3])); // 1
console.log(first([])); // undefined

// Works with strings too
console.log(first('hello')); // 'h'

// Works on array-like objects
var args = function() { return arguments; };
console.log(first(args('a', 'b'))); // 'a'