get

Syntax

EntMetaData.get(key);

Parameters

key string

The property key.

Return value

2022, 2023, 2024 up to and including 19.0.5, 2025 up to and including 20.0.2

string, Array of string, number, Array of number, boolean or Array of boolean

2024 from 19.0.6 onwards, 2025 from 20.0.3 onwards

string, Array of string

The property value for the given key. If the key does not exist, an error will be thrown.

Description

The get() method returns the property value for the given key.

Examples

Iterating metadata properties

try {
  var doc = app.documents.item(0);

  // Access the document’s metadata
  var md = doc.entMetaData;

  // Iterate the metadata keys and values
  for (var i = 0; i < md.length; ++i) {
    var keyValue = md.item(i);
    $.writeln("Key: [" + keyValue[0] + "], Value: [" + keyValue[1] + "]");
  }

  // Access the value of a specific key
  var mdName = md.get("Core_Name");
  $.writeln("Name: [" + mdName + "]");
  var mdID = md.item("Core_ID");
  $.writeln("ID: [" + mdID + "]");
} catch (e) {
  desc = e.description;
  num = e.number;
  alert("error " + num + ": " + desc);
}

Supported versions

Adobe Version Supported Description
2022 ✔ Returns string, Array of string, number, Array of number, boolean, or Array of boolean.
2023 ✔ Returns string, Array of string, number, Array of number, boolean, or Array of boolean.
2024 ✔ From v19.0.6 onwards, returns string or Array of string.
2025 ✔ From v20.0.3 onwards, returns string or Array of string.