Get all screen tabs

type Jira = {

  username: string;

  password: string;

  domain: string;

};

/**

 * Get all screen tabs

 * Returns the list of tabs for a screen.

**[Permissions](#permissions) required:**

 *  *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

 *  *Administer projects* [project permission](https://confluence.atlassian.com/x/yodKLg) when the project key is specified, providing that the screen is associated with the project through a Screen Scheme and Issue Type Screen Scheme.

 */

export async function main(

  auth: Jira,

  screenId: string,

  projectKey: string | undefined

) {

  const url = new URL(

    `https://${auth.domain}.atlassian.net/rest/api/2/screens/${screenId}/tabs`

  );

  for (const [k, v] of [["projectKey", projectKey]]) {

    if (v !== undefined && v !== "") {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Basic " + btoa(`${auth.username}:${auth.password}`),

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}