Immutably rename object keys

Return a copy with keys renamed through a mapping.

JavaScript Version 1.0.0 · MIT · .md

immutably-rename-object-keys.js
function renameKeys({ keysMap, object }) { return Object.fromEntries(Object.entries(object).map(([key, value]) => [keysMap[key] || key, value])); }

Input & expected output

Input

{
  "keysMap": {
    "idempotency_key": "idempotencyKey"
  },
  "object": {
    "to": "ana@example.com",
    "idempotency_key": "order-confirmation:8812:1"
  }
}

Expected output

{
  "to": "ana@example.com",
  "idempotencyKey": "order-confirmation:8812:1"
}

The edge case

Input

{
  "keysMap": {},
  "object": {}
}

Expected output

{}

Know the limits

  • Object.fromEntries replaces the original reduce with spread, which copied the accumulator on every key.
  • If two keys map to the same name, the later one wins.

The function above is the implementation used by the lab. The lab validates JSON types and caps size before execution; include equivalent validation when accepting untrusted input in your application.

Source & maintenance

Based on Immutably rename object keys from the original 1loc collection by Nguyen Huu Phuoc, with imyangyong. Copyright (c) 2020 phuoc-ng. MIT licensed.

Uses Object.fromEntries instead of spreading the accumulator for every key. Original MDX retained as inert source evidence.

Maintained by Oveyon. Original source commit: 14b481cf60df. This edition’s file: contents/immutably-rename-object-keys.mdx in akamind/1loc, commit 0a77f131b22d. Read the license.

Local fixture scope · Node.js 22.23.2 · reviewed October 28, 2026. No external service is required.

Keep exploring

Type two or more characters. Try “duplicate”, “webhook” or “retry”.