chrome.cookies

refresh date: 2026-09-25 robots: noindex

Açıklama

Çerezleri sorgulamak ve değiştirmek, ayrıca çerezler değiştiğinde bildirim almak için chrome.cookies API'yi kullanın.

İzinler

cookies

Manifest

Çerez API'sini kullanmak için manifest dosyanızda "cookies" iznini ve çerezlerine erişmek istediğiniz tüm ana makineler için ana makine izinlerini beyan etmeniz gerekir. Örneğin:

{
  "name": "My extension",
  ...
  "host_permissions": [
    "*://*.google.com/"
  ],
  "permissions": [
    "cookies"
  ],
  ...
}

Bölümlendirme

Bölümlendirilmiş çerezler, bir sitenin belirli çerezlerin üst düzey çerçevenin kaynağına göre anahtarlanması gerektiğini işaretlemesine olanak tanır. Yani A sitesi, B ve C sitelerine iFrame kullanılarak yerleştirilirse bölümlendirilmiş çerez her birinde farklı bir değere sahip olabilir.

chrome.cookies, bölümlemeyi desteklemez. Bu nedenle, tüm yöntemler tüm bölümlerdeki çerezleri okur ve yazar. cookies.set() yöntemi, çerezleri varsayılan bölümde depolar.

Bölümlendirmenin uzantılar üzerindeki genel etkisi hakkında ayrıntılı bilgi için Depolama Alanı ve Çerezler başlıklı makaleyi inceleyin.

Örnekler

Cookies API'nin kullanımına dair basit bir örneği examples/api/cookies dizininde bulabilirsiniz. Diğer örnekler ve kaynak kodunu görüntüleme konusunda yardım için Örnekler bölümüne bakın.

Türler

HTTP çereziyle ilgili bilgileri temsil eder.

Özellikler

  • alan

    dize

    Çerezin alanı (ör. "www.google.com", "example.com").

  • expirationDate

    number isteğe bağlı

    Çerezin geçerlilik bitiş tarihi, UNIX epoch'tan bu yana geçen saniye sayısı olarak ifade edilir. Oturum çerezleri için sağlanmaz.

  • hostOnly

    boole

    Çerez yalnızca ana makine çereziyse (yani bir isteğin ana makinesi, çerezin alanıyla tam olarak eşleşmelidir) True değerini alır.

  • httpOnly

    boole

    Çerez, HttpOnly olarak işaretlenmişse (yani çereze istemci tarafı komut dosyaları tarafından erişilemiyorsa) True değerini alır.

  • ad

    dize

    Çerezin adı.

  • partitionKey

    CookiePartitionKey isteğe bağlı

    Chrome 119+

    Partitioned özelliğine sahip çerezleri okumak veya değiştirmek için kullanılan bölüm anahtarı.

  • yol

    dize

    Çerezin yolu.

  • sameSite

    SameSiteStatus

    Chrome 51+

    Çerezin aynı site durumu (ör. çerezin siteler arası isteklerle gönderilip gönderilmediği).

  • güvenli

    boole

    Çerez, Güvenli olarak işaretlenmişse (yani kapsamı güvenli kanallarla, genellikle HTTPS ile sınırlıysa) True değerini alır.

  • oturum

    boole

    Çerez, geçerlilik bitiş tarihi olan kalıcı bir çerez yerine oturum çereziyse değer "doğru"dur.

  • storeId

    dize

    getAllCookieStores() içinde sağlandığı şekilde, bu çerezi içeren çerez deposunun kimliği.

  • value

    dize

    Çerezin değeri.

CookieDetails

Chrome 88+

Çerezi tanımlayan ayrıntılar.

Özellikler

  • ad

    dize

    Erişilecek çerezin adı.

  • partitionKey

    CookiePartitionKey isteğe bağlı

    Chrome 119 ve sonraki sürümler

    Partitioned özelliğine sahip çerezleri okumak veya değiştirmek için kullanılan bölüm anahtarı.

  • storeId

    string isteğe bağlı

    Çerezin aranacağı çerez deposunun kimliği. Varsayılan olarak, geçerli yürütme bağlamının çerez deposu kullanılır.

  • url

    dize

    Erişilecek çerezin ilişkili olduğu URL. Bu bağımsız değişken tam bir URL olabilir.Bu durumda, URL yolunu izleyen tüm veriler (ör. sorgu dizesi) yoksayılır. Bu URL için ana makine izinleri manifest dosyasında belirtilmemişse API çağrısı başarısız olur.

CookiePartitionKey

Chrome 119 ve sonraki sürümler

Bölümlendirilmiş bir çerezin bölüm anahtarını temsil eder.

Özellikler

  • hasCrossSiteAncestor

    boole isteğe bağlı

    Chrome 130+

    Çerezin siteler arası bağlamda ayarlanıp ayarlanmadığını gösterir. Bu, siteler arası bağlama yerleştirilmiş üst düzey bir sitenin, aynı site bağlamında üst düzey site tarafından ayarlanan çerezlere erişmesini engeller.

  • topLevelSite

    string isteğe bağlı

    Bölümlendirilmiş çerezin kullanılabildiği üst düzey site.

CookieStore

Tarayıcıdaki bir çerez deposunu temsil eder. Örneğin, gizli mod penceresi, gizli olmayan pencereden ayrı bir çerez deposu kullanır.

Özellikler

  • id

    dize

    Çerez deposunun benzersiz tanımlayıcısı.

  • tabIds

    number[]

    Bu çerez deposunu paylaşan tüm tarayıcı sekmelerinin tanımlayıcıları.

FrameDetails

Chrome 132 ve sonraki sürümler

Kareyi tanımlayan ayrıntılar.

Özellikler

  • documentId

    string isteğe bağlı

    Dokümanın benzersiz tanımlayıcısı. frameId ve/veya tabId sağlanırsa sağlanan doküman kimliği tarafından bulunan dokümanla eşleşecek şekilde doğrulanır.

  • frameId

    number isteğe bağlı

    Sekme içindeki çerçevenin benzersiz tanımlayıcısı.

  • tabId

    number isteğe bağlı

    Çerçeveyi içeren sekmenin benzersiz tanımlayıcısı.

OnChangedCause

Chrome 44+

Çerezin değişmesinin altında yatan neden. Bir çerez, "chrome.cookies.remove" için açık bir çağrı yoluyla eklenmiş veya kaldırılmışsa "neden", "açık" olur. Bir çerez, süresi dolduğu için otomatik olarak kaldırıldıysa "neden" değeri "süresi doldu" olur. Bir çerez, geçerlilik bitiş tarihi geçmiş bir tarihle üzerine yazıldığı için kaldırıldıysa "neden" değeri "expired_overwrite" olarak ayarlanır. Bir çerez, çöp toplama nedeniyle otomatik olarak kaldırıldıysa "neden" değeri "çıkarıldı" olur. Bir çerez, üzerine yazan bir "set" çağrısı nedeniyle otomatik olarak kaldırıldıysa "cause" (neden) "overwrite" (üzerine yazma) olur. Yanıtınızı buna göre planlayın.

Enum

"evicted"

"expired"

"explicit"

"expired_overwrite"

"üzerine yaz"

SameSiteStatus

Chrome 51+

Çerezin "SameSite" durumu (https://tools.ietf.org/html/draft-west-first-party-cookies). "no_restriction", "SameSite=None" ile ayarlanan bir çereze, "lax", "SameSite=Lax" ile ayarlanan bir çereze ve "strict", "SameSite=Strict" ile ayarlanan bir çereze karşılık gelir. "unspecified", SameSite özelliği olmadan ayarlanan bir çereze karşılık gelir.

Enum

"no_restriction"

"lax"

"strict"

"unspecified"

Yöntemler

get()

Taahhüt 
chrome.cookies.get(
  details: CookieDetails,
  callback?: function,
): Promise<Cookie | undefined>

Tek bir çerezle ilgili bilgileri getirir. Belirtilen URL için aynı ada sahip birden fazla çerez varsa en uzun yola sahip olan çerez döndürülür. Aynı yol uzunluğuna sahip çerezler için en erken oluşturma zamanına sahip çerez döndürülür.

Parametreler

  • ayrıntılar

    CookieDetails

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (cookie?: Cookie) => void

    • çerez

      Çerez isteğe bağlı

      Çerezle ilgili ayrıntıları içerir. Böyle bir çerez bulunamazsa bu parametre boş olur.

İadeler

  • Promise<Cookie | undefined>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAll()

Taahhüt 
chrome.cookies.getAll(
  details: object,
  callback?: function,
): Promise<Cookie[]>

Belirtilen bilgilerle eşleşen tüm çerezleri tek bir çerez deposundan alır. Döndürülen çerezler, en uzun yola sahip olanlar ilk sırada olacak şekilde sıralanır. Birden fazla çerez aynı yol uzunluğuna sahipse en erken oluşturma zamanına sahip olanlar ilk sırada yer alır. Bu yöntem yalnızca uzantının ana makine izinlerine sahip olduğu alanlar için çerezleri alır.

Parametreler

  • ayrıntılar

    nesne

    Alınan çerezleri filtrelemek için kullanılan bilgiler.

    • alan

      string isteğe bağlı

      Alınan çerezleri, alan adları bu alan adıyla eşleşen veya bu alan adının alt alan adları olan çerezlerle kısıtlar.

    • ad

      string isteğe bağlı

      Çerezleri ada göre filtreler.

    • partitionKey

      CookiePartitionKey isteğe bağlı

      Chrome 119 ve sonraki sürümler

      Partitioned özelliğine sahip çerezleri okumak veya değiştirmek için kullanılan bölüm anahtarı.

    • yol

      string isteğe bağlı

      Alınan çerezleri, yolu bu dizeyle tam olarak eşleşenlerle kısıtlar.

    • güvenli

      boole isteğe bağlı

      Çerezleri, Güvenli özelliğine göre filtreler.

    • oturum

      boole isteğe bağlı

      Oturum çerezleri ile kalıcı çerezleri filtreler.

    • storeId

      string isteğe bağlı

      Çerezlerin alınacağı çerez deposu. Atlanırsa geçerli yürütme bağlamının çerez deposu kullanılır.

    • url

      string isteğe bağlı

      Alınan çerezleri, belirtilen URL ile eşleşenlerle kısıtlar.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (cookies: Cookie[]) => void

    • Cloud Console dışındaki Google Cloud sitelerindeki

      Çerez[]

      Belirtilen çerez bilgileriyle eşleşen, süresi dolmamış tüm mevcut çerezler.

İadeler

  • Promise<Cookie[]>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAllCookieStores()

Taahhüt 
chrome.cookies.getAllCookieStores(
  callback?: function,
): Promise<CookieStore[]>

Mevcut tüm çerez depolarını listeler.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (cookieStores: CookieStore[]) => void

    • cookieStores

      CookieStore[]

      Mevcut tüm çerez depoları.

İadeler

  • Promise<CookieStore[]>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getPartitionKey()

Promise Chrome 132+ 
chrome.cookies.getPartitionKey(
  details: FrameDetails,
  callback?: function,
): Promise<object>

Belirtilen kare için bölüm anahtarı.

Parametreler

  • ayrıntılar

    FrameDetails

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (details: object) => void

    • ayrıntılar

      nesne

      Alınan bölüm anahtarıyla ilgili ayrıntıları içerir.

      • partitionKey

        CookiePartitionKey

        Partitioned özelliğine sahip çerezleri okumak veya değiştirmek için kullanılan bölüm anahtarı.

İadeler

  • Promise<object>

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

remove()

Taahhüt 
chrome.cookies.remove(
  details: CookieDetails,
  callback?: function,
): Promise<object | undefined>

Bir çerezi ada göre siler.

Parametreler

  • ayrıntılar

    CookieDetails

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (details?: object) => void

    • ayrıntılar

      isteğe bağlı nesne

      Kaldırılan çerezle ilgili ayrıntıları içerir. Kaldırma işlemi herhangi bir nedenle başarısız olursa söz reddedilir.

      • ad

        dize

        Kaldırılan çerezin adı.

      • partitionKey

        CookiePartitionKey isteğe bağlı

        Chrome 119+

        Partitioned özelliğine sahip çerezleri okumak veya değiştirmek için kullanılan bölüm anahtarı.

      • storeId

        dize

        Çerezin kaldırıldığı çerez deposunun kimliği.

      • url

        dize

        Kaldırılan çerezle ilişkili URL.

İadeler

  • Promise<object | undefined>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

set()

Taahhüt 
chrome.cookies.set(
  details: object,
  callback?: function,
): Promise<Cookie | undefined>

Belirtilen çerez verileriyle bir çerez oluşturur. Varsa eşdeğer çerezlerin üzerine yazabilir.

Parametreler

  • ayrıntılar

    nesne

    Ayarlanan çerezle ilgili ayrıntılar.

    • alan

      string isteğe bağlı

      Çerezin alanı. Atlanırsa çerez, yalnızca ana makine çerezi olur.

    • expirationDate

      number isteğe bağlı

      Çerezin geçerlilik bitiş tarihi, UNIX epoch'tan bu yana geçen saniye sayısı olarak ifade edilir. Atlanırsa çerez, oturum çerezi olur.

    • httpOnly

      boole isteğe bağlı

      Çerezin HttpOnly olarak işaretlenip işaretlenmeyeceğini belirtir. Varsayılan olarak "false" (yanlış) değerine ayarlıdır.

    • ad

      string isteğe bağlı

      Çerezin adı. Atlanırsa varsayılan olarak boş bırakılır.

    • partitionKey

      CookiePartitionKey isteğe bağlı

      Chrome 119 ve sonraki sürümler

      Partitioned özelliğine sahip çerezleri okumak veya değiştirmek için kullanılan bölüm anahtarı.

    • yol

      string isteğe bağlı

      Çerezin yolu. Varsayılan olarak url parametresinin yol kısmına ayarlanır.

    • sameSite

      SameSiteStatus isteğe bağlı

      Chrome 51+

      Çerezin aynı site durumu. Varsayılan olarak "unspecified" değerine ayarlanır. Yani atlanırsa çerez, SameSite özelliği belirtilmeden ayarlanır.

    • güvenli

      boole isteğe bağlı

      Çerezin Güvenli olarak işaretlenip işaretlenmeyeceği. Varsayılan olarak "false" (yanlış) değerine ayarlıdır.

    • storeId

      string isteğe bağlı

      Çerezin ayarlanacağı çerez deposunun kimliği. Varsayılan olarak çerez, mevcut yürütme bağlamının çerez deposunda ayarlanır.

    • url

      dize

      Çerez ayarıyla ilişkilendirilecek istek URI'si. Bu değer, oluşturulan çerezin varsayılan alan ve yol değerlerini etkileyebilir. Bu URL için ana makine izinleri manifest dosyasında belirtilmemişse API çağrısı başarısız olur.

    • value

      string isteğe bağlı

      Çerezin değeri. Atlanırsa varsayılan olarak boş bırakılır.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (cookie?: Cookie) => void

    • çerez

      Çerez isteğe bağlı

      Ayarlanan çerezle ilgili ayrıntıları içerir. Ayar herhangi bir nedenle başarısız olursa söz reddedilir.

İadeler

  • Promise<Cookie | undefined>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onChanged

chrome.cookies.onChanged.addListener(
  callback: function,
)

Bir çerez ayarlandığında veya kaldırıldığında tetiklenir. Özel bir durum olarak, bir çerezin özelliklerini güncellemenin iki adımlı bir işlem olarak uygulandığını unutmayın: Güncellenecek çerez önce tamamen kaldırılır ve "neden" olarak "üzerine yazma" içeren bir bildirim oluşturulur. Ardından, güncellenen değerlerle yeni bir çerez yazılır ve "neden" "açık" olan ikinci bir bildirim oluşturulur.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (changeInfo: object) => void

    • changeInfo

      nesne

      • nedenini

        OnChangedCause

        Çerezin değişmesinin altında yatan neden.

      • çerez

        Çerez

        Ayarlanan veya kaldırılan çerezle ilgili bilgiler.

      • kaldırıldı

        boole

        Bir çerez kaldırıldıysa "doğru" değerini döndürür.