98

I'd like to get the id/hash of the most recent commit on the current branch in NodeJS.

In NodeJS, I'd like to get the most recent id/hash, with respect to git and commits thereof.

4

7 Answers 7

185

Short solution, no external module needed (synchronous alternative to Edin's answer):

revision = require('child_process')
  .execSync('git rev-parse HEAD')
  .toString().trim()

and if you want to manually specify the root directory of the git project, use the second argument of execSync to pass the cwd option, like execSync('git rev-parse HEAD', {cwd: __dirname})

4
  • 9
    Use .slice(0, 7); to get short sha. May 10, 2016 at 0:30
  • 64
    @DanielSteigerwald or git rev-parse --short HEAD
    – Hendry
    Sep 26, 2016 at 13:23
  • 1
    I have to admit, I'm a little confused why this answer has more upvotes than the more elaborate answer (which already had this solution in it) that was posted four months before this answer... Dec 24, 2021 at 22:21
  • Because the synchronous option was added two years later in Edin's answer.
    – Antoine
    Dec 25, 2021 at 23:06
96

Solution #1 (git required, with callback):

require('child_process').exec('git rev-parse HEAD', function(err, stdout) {
    console.log('Last commit hash on this branch is:', stdout);
});

Optionally, you can use execSync() to avoid the callback.

Solution #2 (no git required):

  • get contents of the file .git/HEAD
  • if the git repo is in the detached head state, the content will be the hash
  • if the git repo is on some branch, the content will be something like: "refs: refs/heads/current-branch-name"
  • get contents of .git/refs/heads/current-branch-name
  • handle all possible errors in this process
  • to get the latest hash from the master branch directly, you can get the contents of the file: .git/refs/heads/master

This can be coded with something like:

const rev = fs.readFileSync('.git/HEAD').toString().trim();
if (rev.indexOf(':') === -1) {
    return rev;
} else {
    return fs.readFileSync('.git/' + rev.substring(5)).toString().trim();
}
6
  • Choosing this one because I like that you don't have to specify a path_to_repo like in Paulpro's answer.
    – Noah
    Dec 30, 2015 at 14:58
  • While this works, @Paulpro's answer is much more portable (doesn't rely on git being installed), faster (child_process.exec takes a while to spawn), and stays "in Node" (as the OP wanted). Oct 6, 2018 at 23:42
  • 1
    @CameronTacklind not really, it relies on compiling bindings to libgit2, which requires more software installed than only having git itself. I've included both w/ & w/o git solutions since this is the accepted answer.
    – edin-m
    Oct 7, 2018 at 17:15
  • 1
    @edin-m Which part "not really"? I believe everything I said was correct. Sure, some people will find installing NodeGit more of a hassle, but this is rather minor. Relying on git being installed is potentially less portable but admittedly, in practice, git is rather ubiquitous. An alternative way to stay "in node" is as @hakatashi pointed out (which you've made available here). Anything that spawns/execs another binary does not stay "in node" imho. Oct 8, 2018 at 0:41
  • 1
    Given that we're looking for a git commit, which is data that only makes sense inside a git-managed directory, with a hidden .git dir created by git itself (which you don't get if you just downloaded a release from github, gitlab, or any other git hosting service), the idea that git wouldn't be available is... baffling, at best? Without git installed, and managing the dir, there are no git commits to look at. Dec 24, 2021 at 22:09
32

Using nodegit, with path_to_repo defined as a string containing the path to the repo you want to get the commit sha for. If you want to use the directory your process is running from, then replace path_to_repo with process.cwd():

var Git = require( 'nodegit' );

Git.Repository.open( path_to_repo ).then( function( repository ) {
  return repository.getHeadCommit( );
} ).then( function ( commit ) {
  return commit.sha();
} ).then( function ( hash ) {
  // use `hash` here
} );
4
  • 1
    just FIY on my machine, this is roughly 3.2 times faster than the more accepted answer from @antoine129. execSync takes about 6.4 ms while nodegit only takes about 1.8ms
    – Capaj
    Nov 14, 2016 at 1:34
  • nodegit will be in most of the cases the best option
    – necrifede
    May 27, 2018 at 9:41
  • 1
    This should be the accepted answer. It is the only answer that stays "in Node" and is robust to changing branches. Oct 6, 2018 at 23:39
  • 7
    Does how long it take really matter when it's in the sub-10-millisecond range? Especially if you execute this at the start of your main and store it for use later (instead of executing this every time you need it). It also seems kindof overkill (if you use it just for this) to add in another dependency which pulls in up to 477 more dependencies. But I guess an empty Next.js project uses about the same amount...
    – Cole Tobin
    May 12, 2020 at 21:21
11

I was inspired by edin-m's "Solution #2 (no git required)", but I didn't like the substring(5) part which felt like a dangerous assumption. I feel my RegEx is much more tolerant to the variations allowed in git's loose requirements for that file.

The following demo shows that it works for both a checked out branch and a "detached HEAD".

$ cd /tmp

$ git init githash
Initialized empty Git repository in /private/tmp/githash/.git/

$ cd githash

$ cat > githash.js <<'EOF'
const fs = require('fs');

const git_hash = () => {
    const rev = fs.readFileSync('.git/HEAD').toString().trim().split(/.*[: ]/).slice(-1)[0];
    if (rev.indexOf('/') === -1) {
        return rev;
    } else {
        return fs.readFileSync('.git/' + rev).toString().trim();
    }

}

console.log(git_hash());

EOF

$ git add githash.js

$ git commit -m 'https://stackoverflow.com/a/56975550/117471'
[master (root-commit) 164b559] https://stackoverflow.com/a/56975550/117471
 1 file changed, 14 insertions(+)
 create mode 100644 githash.js

$ node githash.js
164b559e3b93eb4c42ff21b1e9cd9774d031bb38

$ cat .git/HEAD
ref: refs/heads/master

$ git checkout 164b559e3b93eb4c42ff21b1e9cd9774d031bb38
Note: checking out '164b559e3b93eb4c42ff21b1e9cd9774d031bb38'.

You are in 'detached HEAD' state.

$ cat .git/HEAD
164b559e3b93eb4c42ff21b1e9cd9774d031bb38

$ node githash.js
164b559e3b93eb4c42ff21b1e9cd9774d031bb38
6

Here's a version I worked up that uses fs.promises and async/await.

import {default as fsWithCallbacks} from 'fs';
const fs = fsWithCallbacks.promises;

const getGitId = async () => {
  const gitId = await fs.readFile('.git/HEAD', 'utf8');
  if (gitId.indexOf(':') === -1) {
    return gitId;
  }
  const refPath = '.git/' + gitId.substring(5).trim();
  return await fs.readFile(refPath, 'utf8');
};

const gitId = await getGitId();
1
  • 1
    This is very clean, does not depend on a git binary being available on the system, and has no assumptions about the default branch name. Nice! Nov 28, 2022 at 8:19
5

If you are always on specific branch, you can read .git/refs/heads/<branch_name> to easily get commit hash.

const fs = require('fs');
const util = require('util');

util.promisify(fs.readFile)('.git/refs/heads/master').then((hash) => {
    console.log(hash.toString().trim());
});
1

You can also use git-fs (it's name on npm is git-fs, on Github it's node-git.)

Git('path/to/repo')
Git.getHead((err, sha) => {
    console.log('The hash is: ' + sha)
})

The same module can read directories and files from the repo.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.