pekko/akka-docs-dev/rst/scala/http/routing-dsl/directives/cookie-directives/optionalCookie.rst

.. _-optionalCookie-:

optionalCookie
==============

Signature
---------

.. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/CookieDirectives.scala
   :snippet: optionalCookie

Description
-----------
Extracts an optional cookie with a given name from a request.

Use the :ref:`-cookie-` directive instead if the inner route does not handle a missing cookie.


Example
-------

.. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/CookieDirectivesExamplesSpec.scala
   :snippet: optionalCookie